•••• •••• 

•••• •••• 



•••• •••• 

•••• •••• 

•••• •••• 

•••• •••• 

•••••••••••••••••• 



•••• •••• •••• 

•e** •••• 9999 
•••• •••• o*»» 



•••••• •••••• 

•••• •••• 

•••• •€•• 

•••• •••• 

••••••••••••••••e* 

•••••••••••••••••• 



••••••••••a 

••••••••••• 

••••••••eaa 

•••••••••e* 



•••• •••• 

•••• •••• 



•••• ••••• 

••••• ••••»•• 

•••••• ••••••••• 

••••••• •••••••«••• 

••••••• ••••••••••• 

•••• •••• •••• 

•••• •••• •••• 

•••• •••• •••• 



•••••••••• ••••• 

o******* •••• 

•••••• 

• ••• 

• e«* 
• •••• 

••••••• 

•••• •••••••• 

•••• ••••••• 



•••• ••••••• 

•••• •••••••• 

••••••• 

• ••• 

•••• ••••• 

••••• ••••••» 

•••••• •••••••«• 

••••••• ••••••0*«»* 

••••••• ••••••e*«** 

•••• •••• •«•• 

•»•• •••• ••e* 

•••• •••• •••• 

••••e«»*c»e* •••«•• 

•••••••••••• •••••• 

•••••••••• ••••• 

•••••••• •••• 

•••••s 

•••••• 

• ••<>•• 
•••••• 

•••• •••• 

•••• •••• 



•••• •••• 

•••• •••• 

•••••• 

•••••• 

••••o* 

•••• •••• 

•••• •••• 



•••• •••• •••• 

•••• •••• •••• 

•••• •••• •••• 

•••••• •••• •••••• 

•••••• •••••• 

•••••• •••••• 

•••••• •••••• 

•••• ••«• 

•••• •••• 



la 



•••• •••• 

•••• •••• 



•••• •••••• 

••••• •••••• 

•••••• •••••• 

••••••• •••••• 

••••••• •••• •••• 

•••• ••••• •••• 

•••• •••••• •••• 

•••• •••••»••••• 

••••••••••••••••••• 

••••••••••• •••••• 

•••••••••• ••••• 



IBM System/3 
Overlay Linkage Editor 
Reference Manual 



Program Numbers: 

5702-SC1 (Models 8 and 10) 
5703-SC1 (Model 6) 
5704-SC1 (Model 15) 
5704-SC2 (Model 15) 
5705-SC1 (Model 12) 



GC21-7561-5 
File No. S3-31 



Preface 



The Overlay Linkage Editor is a part of the IBM System/3 
Model 15 System Control Program (Program Number 
5704-SCI), and is a separately orderable feature of the 
IBM System/3 Model 10 Disk System (Feature 6026/6027), 
IBM System/3 Model 12 (Feature 6026/6027), and the IBM 
System/3 Model 6 (Feature 601 1/60 1 2). This manual pro- 
vides reference information for programmers using the 
Overlay Linkage Editor capabiUties of System/3. This man- 
ual is intended for experienced programmers who plan to 
link-edit their own object modules rather than have the 
language translators (assemblers and compilers) do the 
Mnk-editing. 



System/3 Model 8 

The System/3 Model 8 is supported by System/3 Model 10 
Disk System control programming and program products. 
TJre facilities described in this pubUcation for the Model 10 
are also applicable to the Model 8, although the Model 8 is 
not referenced. It should be noted that not all devices and 
features which are available on the Model 10 are available 
on the Model 8. Therefore, Model 8 users should be famiUar 

with the contents oi IBM SystemI 3 Model 8 Introduction, 

GC21-5114. 



Note: In this publication there are some references to 
support of 64K bytes of main storage. A System/3 Model 
10 with a 64K processing unit is available only as an RPQ. 
Your IBM Marketing Representative can provide informa- 
tion about this. 



Sixth Edition (September 1978) 

This is a major revision of. and obsoletes GC21-756M and technical newsletters 
GN21-5406 and GN21-5585. Changes or additions to the text and illustrations are 
indicated by a vertical line to the left of the change or addition. 

This edition applies to the System/3 program versions U.stcd below and to all subsequent 
versions and modifications until otherwise indicated in new editions or technical news- 
letters. 

Version Modifications Program Number Feature Number Model 



15 

15 

6 

3 
4 



5702-SCl 6026,6027 8,10 

5703-SCl 6010,6011 4,6 

5704-SCl 6033,6070,6071 15A, 15B, 

5704-SC2 6011,6012 15D 

5705-SCl 6070,6071 12 



15C 



Changes are periodically made to the specifications herein; before using this publication 
in connection with the operation of IBM systems, refer to the latest IBM System/3 
Bibliography, GC20-8080, for the editions that are appUcable and current. 

Use this publication only for the purposes stated in the Preface. 

Publications are not stocked at the address below. Requestes for copies of IBM publi- 
cations and for technical information about the system should be made to your IBM 
representative or to the branch office serving your locality. 

This publication could contain technical inaccuracies or typographical errors. Address 
your comments about this publication to IBM Corporation, Publications, Department 
245, Rochester, Minnesota 5590L IBM may use and distribute any of the information 
you supply in any way it believes appropriate without incurring any obligation whatever. 
You may, of course, continue to use the information you supply. 

© Copyright International Business Machines Corporation 1971, 1972, 1973, 1974, 
1974, 1975, 1978 
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Introduction 



Unkage editor processing is necessary foUowing the assem- 
bly or compUation of any program. The output of a lan- 
guage translator (assembler or compiler) is called an object 
module (see Figure 1). An object module cannot be run 
as a program until it is link-edited into a load module. Ob- 
ject modules and load modules can reside on cards or in the 
object library on disk (see Figure 2). 



Source 
Program 



Object 
Module 



Load 
Module 




V / Language \ 

^ \ Translator / 




V w / Linkage 
/ \ Editor 



Figure 1. Preparing a Source Program for Execution 
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Source Library (opttonai) 



Object Library Directory 

Permanent Entries 

— O Library Entries 
R Library Entries 



Temporary Entries 

— Library Entries 

— R Library Entries 



User Area 



The O library entries are load modules. They are loaded 
by the LOAD OCL statement. 

The R library entries are object modules that must be 
link-edited into a load module before they can be loaded. 



Figure 2. Format of Object Library 



The Overlay Linkage Editor provides a compiler entry and 
a user entry. The compiler entry provides the following 
functions: 

• Punches into cards and/or catalogs into the object library 
on a disk the output object module of a language trans- 
lator such as IBM System/3 FORTRAN, COBOL, Basic 
Assembler, and Model 15 RPG II. 



Tlie user entry allows the user to link-edit IBM System/3 
Basic Assembler object modules and object modules built 
by other language translators into load modules. Tlie user 
can influence the determination of overlays himself or he 
can allow the Overlay Linkage Editor to determine the 
overlay structure. Tlie load modules can be punched into 
cards and/or cataloged into an object library on disk. 



• Link-edits the output of language translators such as 
IBM System/3 FORTRAN, COBOL and Model 1 5 
RPG II into a load module and punches the load 
module into cards and/or catalogs it into an object 
library on disk. The assigning of modules to overlay 
segments is determined automatically by the Overlay 
Linkage Editor. 



SYSTEM CONFIGURATION 

For information concerning the minimum system config- 
uration for Overlay Linkage Editor and additional devices 
supported, see one of the following publications, as appro- 
priate for your System/3 model: 

• IBM System/3 Models 4. 6. 8. 10. and 12 System 
Generation Reference Manual, GC21-5I26 

• IBM System! 3 Model 15 System Generation Reference 
Manual. GC21-7616 



PRIMARY STORAGE REQUIREMENTS 

The primary storage requirements for the execution of the 
Overlay Linkage Editor are as follows: 



System/ 3 Model 


Main Storage 


Models 4 and 6 


7K 


Models 8 and 10 


7K 


Model 12 


8K 


Model 1 5 


lOK 



• IBM System/3 Model 4 Introduction. GC2 1-5146 

• IBM System/ 3 Model 6 Introduction, G A2 1 -9 1 22 

• IBM System/ 3 Model 8 Introduction, GC2 1-5114 

• IBM System/ 3 Model 12 Introduction, GC2 1-5116 

• IBM System/3 Model 15 Introduction. GC2 1 -5094 



SECONDARY STORAGE REQUIREMENTS 

The Overlay Linkage Editor requires 10 tracks in the object 
library. For execution, work space must be available as 
follows: 





5444 


5445 


3340 1 




5444 
Simulation Area 


Main Data Area 


Models 4 
and 6 


X 








Models 8 
and 10 


X 








Model 12 






X 




Model 15 


X 


X 


X 


X 



This space can be specified by the user or allocated by the 
Overlay Linkage Editor (see index entry: OCL statements). 



ERROR HALTS 

Halts are issued with system halt messages on SYSLOG for 
error conditions, if the log is off, a second level halt is 
issued to fully dei'ine the error condition (Models 6, 10 
Disk System, and 12). 



CHANGES IN LOAD MODULE SIZE 

Changes made to the Overlay Linkage Editor from, release 
to release may cause change in the size of the output load 
module. For example, a program that fits in 4K on one re- 
lease may not fit in 4K on the next release. 
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Using the Overlay Linkage Editor 



Tliis section describes the compiler and user entries to the 
Overlay Linkage Editor and the storage map printed by the 
Overlay Linkage Editor to inform the user of the structure 
of his program. The input object modules used by both 
entries of the Overlay Unkage Editor are described in 
Appendix B. 



COMPILER ENTRY 

The compiler entry to the Overlay Linkage Editor is used 
by language translators to punch and/or catalog their out- 
put object modules (object modules are described in Ap- 
pendix B). Language translators, such as IBM Systeni/3 
FORTRAN, COBOL, and RPG II (Model 1 5 only), can 
also specify link-editing. The Overiay Linkage Editor 
then link-edits tlie object module into a load module 
and punches and/or catalogs the load module. 

WTien the user compiles an object module and immediately 
link-edits it into a load module via the compiler entry, he 
can intlueace the determination of overlays only by speci- 
fying the category of the object modules on the compiler 
input. For the Overlay Linkage Editor method of detcr- 
mming overlay structure, see index entry: determining 
overlay modules. 



USER ENTRY 

To use the Overlay Linkage Editor, the user must supply: 

• Operation Control Liinguage (OCL) statements 

• Overlay Linkage Editor Control statements 

• Modules to be linked (described in Appendix B) 



OCL Statements 

The following OCL statements are examples of loading the 
Overlay Linkage Editor via the user entry: 



Model 10 Disk System, Model 12, and Model 15 


// LOAD $OLINK,unit (unit can be R1,F1,R2, or F2) 


,7 FILE NAME 


-$SOURCE, 


\ (These two FILE state- 
ments are optional and 


,// FILE NAME- 


-$WORK, 


1 are standard Fl LE state- 
■ ■ ' j ments used by the 


// RUN 




compilers.) 


Model 6 






010 LOAD 


NAME- 


SOLINK 


Oil 


UNIT- 


(R1,F1,R2,or F2) 


020 FILE 


NAME- 


SSOURCEX 






(These two FILE 






^statements are 


030 FILE 


NAME- 


SWORK 1 optional and are 






standard FILE 






statements used by 






the compilers.) 


MODIFY 






RUN 







The Overlay Linkage Editor requires from 10 to 30 tracks 
of disk space. FILE statements should be supplied for 
large programs (25K or more), or if the partition size that 
the Overlay Linkage Editor is currently in, is 25K or more, 
if the two FILE statements are supplied, they must be the 
same as the standard FILE statements used by the compilers. 

The Overlay Linkage Editor will tlnd disk space if FILE 
statements are not supplied. Space will be assigned on Fl 
if there is a minimum of 10 tracks available (even thou|^i 
10 tracks may not be sufficient for a large program). If 
the minimum space is not available on Fl , space will be 
assigned on Rl . 

You may save time if you supply Fl LE statements to place 
the files optimally(see Appendix C, Performance Improve- 
ments); for the Model 15, files should be placed on a 
5445 disk drive (or 3340 main data area) for best perfor- 
mance. FILE statements can also be supplied to ensure 
that the Overlay Linkage Editor has adequate work space 
to complete the link-edit. 

The OCL statements can be entered from the system input 
device or called from the procedure library. 



Control Statements 

Overlay Linkage Editor control statements can be entered 
from the system input device or from the procedure library. 
The types of control statements are: 

1 . PHASE statement (optional). 

2. OPTIONS statement (optional). 

3. INCLUDE statements and/or object modules in card 
form (required). The first object module encountered 
(either in card form or indicated on an INCLUDE card) 
will be the mainline routine. 



4. 
5. 
6. 

7. 



GROUP statement (optional). 
CATEGORY statement (optional). 
EQUATE statement (optional). 
END statement (required). 



Control Statement Summary 



Use 



Define 

Load 

Module* 

Define 
Environment 



Define Object 
Modules 

Group Object 
Modules 
Together 
in Storage 

Change 
Category 
of Object 
Module 

Equate 
Module 
Names 

End of 
Control 
Statements 



Control Statements 



// PHASE NAME-name.UNIT-code.PUNCH- / "^^^ 

) NO 



.RETAIN-,; P I ,LINKADD- / S+X'aaaa' ( RLD- 
R ) I X'aaaa' ( 



{'^} 



II OPTIONS UPACK-code,CORE-annK,LEVEL-nnn,ENTRY-label, 
ATTR-xxx,MAP- /YES 
! 




// INCLUDE NAME-name (or 'name, name, . . . name'),UNIT-code 



// GROUP NAME-name (or 'name,name, . . . name'), AREA-USER 



// CATEGORY NAME-name (or 'name.name, . . . name'),VALUE-nnn 



// EQUATE OLDNAME-name (or 'name.name, . . . name'),NEWNAME-name (or 'name.name, . . . name') 



// END 



*RLD- 



YES 
NO 



applies only to Model 15 
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Parameter Summary 

The following is a discussion of the parameters for each of 
the control statements. Wlien there is a default value for 
a parameter, the default value is underlined. 



PHASE Statement 

The PHASE statement specifies the name and destination 
of the load module. If the PHASE statement is omitted, 
the load module is assigned the same name as the mainline 
routine (see index entry: INCLUDI: statement) and is 
cataloged as a temporary entry in the object library of the 
piogram pack. 



\yes/ ii^ 1^ ^ (yes) 

// PHASE NAME- name, UNIT-code,PUNCH- < „ ■ .RETAIN- <^, P > ,LINKADD-< S+X'aaaa7 ,RLD- < =- > 

r°~\ 1 R i ( X'aaaa' j I ^° / 




NAME- name 


The name that the load module has in the object library directory. If the NAME 

parameter is not supplied, the load module assumes the NAME of the mainline 

routine. The name can be from one to six characters long and can contain any 

combination of System/S characters except blanks, commas, quotes, or periods. 

The first character must be alphabetic. ] 


UNIT-code 


Disk where the load module is placed. Possible codes are Rl, F1 , R2, and F2. 
If neither the UNIT parameter nor the PUNCH parameter is specified, the load 
module is put on the program pack. 


PUNCH- ( ^^^ \ 


Specifies whether to punch the load module. If not supplied, the default is NO. 
The load module can be both punched into cards and put m the object library by 
specifying both UNIT and PUNCH parameters. 


RETAIN- -j P" (• 


Specifies whether the load module is to be cataloged as a temporary or permanent 
entry in the object library directory. RETAIN- R means replace an existing entry 
with the same name. The RETAIN type of the new module is P. If no entry 
exists with the same name, the new entry is added with a permanent designation 
(P). If RETAIN is not specified, T is the default. If RETAIN-P or R is specified, 
all previous temporary modules are deleted from the library. If this parameter is 
specified with PUNCH- YES, the retain code is specified on the COPY card that 
is punched with the module. 


1- I 
LINKADD-< S+X'aaaa' > 

' X'aaaa' •' 


Specifies the link-edit start address, which is the address assigned to the first byte of the 
link edited load module. On the Model 1 5, if S is specified, the start address is X'4000', 
An absolute address can be specified by coding X'aaaa', where aaaa is an absolute address. 
S+X'aaaa' is coded to specify the end of the supervisor plus an absolute address. If this 
parameter is not coded, S is assumed. If the start address plus the number of bytes in 
the program exceeds X'FFFF', the program is link-edited to start at X'OOOO'. (The 
System Control Program (Program Number 5704-SC2] is link-edited to the largest 
possible multiple of 2K,) This parameter does not affect the loading of the load module 
(see index entry: link-edit start addresses). 


-- { :- } 


Specifies whether a program will be produced with Text-Relocation Directory 
records (RLDs). If this parameter is not supplied, YES is the default. This 
parameter applies only to the Model 1 5. 



OPTIONS Statement 

The OPTIONS statement describes the load module and 
specifies the location of user object modules and the type 
of linkage editor output. If the entire OPTIONS statement 
or any of the parameters are omitted, the defaults given 
are used. 



// OPTIONS UPACK-code,CORE-annK,LEVEL-nnn,ENTRY-label,ATTR-xxx,MAP- 



UPACK-code 



CORE-annK 



LEVEL-nnn 



ENTRY-label 



YES 

NO 

XREF 



Disk where user modules to be link-edited can be found. If UPACK is not 
specified, the linkage editor looks for the user modules on the pack that the 
Overlay Linkage Editor is on. This keyword is used when the Overlay Linkage 
Editor performs AUTOLINK. 



Storage size the load module has available for execution. If specified, the 
directory entry contains this size even though the actual size required by 
the load module is less. If not specified, the current partition size is used 
to determine when overlays are required and the directory entry contains 
the actual load module size. This parameter is needed only if the partition 
size at execution will be different from what it is at link-edit time, 
a = increments of 1/4 K 

Q = 1/4or 256 bytes 

H - 1/2 or 512 bytes 

T = 3/4 or 768 bytes 

'-- zero bytes 

nn - 1 K increments 

Example: a04K - 1/4K + 4K = 256 + 4096 =' 4352 bytes 



Number that is placed in the level entry in the object directory entry. Differ- 
ent modification levels of load modules can be assigned different level values. 
The maximum value for nnn is 255. Default value is 001, except for 
load modules generated by the following Model 15D compilers: 

5704-RG2, RPG II = 253* 

5704-CB2, COBOL = 254' 

5704-FO2, FORTRAN - 255* 



An entry point or module NAME of an included module. Default is the entry 
point of the mainline routine. 



' If u compiler requested R-module is link-edited usmi: the level 
parameter of another compiler, erroneous time/date information 
will be printed in the module directory listing. 

If a level value of 000 through 25 2 is used, tlie time/date infor- 
mation will not he printed in the module directory listine. 
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ATTR— XXX or 
'xxx,xxx, . . . 
xxx' 



Attributes of the module being link-edited. If ATTR is not specified, no attributes are 
assigned. 

xxx = INQ - Inquiry. This program can be run in either program level and dedicates the use 
of the Inquiry key (PA1 key on Model 15) to its program level (normally used 
to start processing). 

lEV —Inquiry Evoking. This program can run on a dedicated system or in level 1 of a 
DPF system. In a DPF system the Inquiry key (or the ROLLOUT command 
in the System Control Program [Program Number 5704-SCIl ) is dedicated to 
the lEV program in level 1 . The Inquiry key is normally used to cause the lEV 
program to be rolled out to allow another program to run. Using the System 
Control Program (Program Number 5704-SC1), the lEV program can run in 
either partition, but can be rolled out only when running in partition 1 . This is 
not supported by the System Control Program (Program Number 5704-SC2). 

DED— Dedicated. In a DPF system, this program must run with the other program 

level inactive. This is not supported by the System Control Program (Program 
Number 5704-SC2). 

SRO— Source Required. This program requires the allocation of the $WORK and 

$SOURCE files. $SOURCE must be filled either from the system input device 
or a source library. Any program with the SRQ attribute will be loaded, and 
relocated, to the normal load point plus 10 bytes. 

DFM— Deferred Mount. This program accepts mounting of packs during its execution. 

SID — SYSIN Dedication. The system input device must be dedicated to this program. 
The device is released at end of job. 

CPR —Checkpoint Restart Program. 

DSR —Direct Source Read. This program can have a // COMPILE statement and a 

no-source-required attribute. SYSIN dedication can also be released by program 
and not have the source-required attribute. The program accesses the source 
library itself. 

MRO— Memory Resident Overlay REMAP Program (Model 15). When specified, the 
program executes the segments in the resident area itself. 

MOV— Memory Resident Overlay MOVE Program (Model 15). When specified, the 
program retains the segment in the resident area but executes the segment in 
the conventional overlay fetch area. 

Notes: 

1. CPR and lEV are mutually exclusive on all models. 
-2. INQ and lEV are mutually exclusive on Models 6, 8, 10, and 12. 

3. MRO, MOV, lEV, and CPR are mutually exclusive on Model 15. 

4. A checkpoint/restart program cannot have external buffers (5704-SC2). 

If ATTR is not specified, no attributes are assigned. 




Type of printer output during link-edit: 

YES = A storage map and messages are printed. If MAP is not specified, YES is assumed. 

NO = No storage map or messages are printed. 

XREF = A storage map, cross-reference list, and messages are printed. 

MSG = Only messages are printed. 



INCLUDE Statement 

fhe INCLUDE statement specifics which object modules are 
to be included in tiie load module. Multiple module names 
may be submitted on one INCLUDh statement. The tirst 
object module named on an INCLUDF: statement or read 
from the SYSIN device is the mainline routine. If a module 
name is not found on the UNIT specified, a halt 1 2 will 
result. By taking a zero option, the program will do a find 
on the next module name in the statement. Either an 
INCLUDE statement or an object module in card form 
must be supplied as input to the Overlay Linkage Editor. 



// INCLUDE NAME-name, UNIT-code 


NAME-name 

or 
NAME — 'name, 
name, . . . name' 


Name(s) of the object module(s) to be 
included in this program. 


UNIT-code 


Disk unit where object module is located. 
If omitted, will default to the program pack. 



GROUP Statement 

The GROUP statement can be used to specify a number of 
object modules that the user wishes to group together in 
storage. Tlic u,ser may design his own overlay structure, 
based on his knowledge of the object modules being link- 
edited, to obtain more efficient loading of overlay segments. 
Tliese modules are put into the same overlay segment or 
partly in an overlay segment and partly in the root segment. 

The first module named in a GROUP statement should be 
referenced by a module that is not in the group (see index 
entry: grouping modules). 

By specifying AREA-USER, you can also use the GROUP 
statement to assign co-resident overlay modules to the user 
overlay area (see index entry: overlay area), thereby possi- 
bly reducing main storage size. 



// GROUP NAME-name, AREA-USER 



NAME-name 

or 
NAME-'name, 
name, . . . name' 



AREA-USER 



The name of a module that should be assigned 
to the user area or the names of the object 
modules that must all be m storage at the same 
time. 



If the modules named in this statement are 
assigned to an overlay, they will be assigned 
to the user overlay area. If a list of names 
('name, name, . . . ') is used with AREA-USER, 
the named modules are grouped in the user 
overlay area. To force multiple modules to 
the user area without grouping them together, 
specify each module name on a separate GROUP 
statement. 



CATEGORY Statement 

The CATECiORY statement is used to temporarily change 
the category value (priority) of object modules. Because 
the priority of an object module infiuences the placement 
of the module into an overlay, the user can delegate the 
module to a different segment by changing the category 
value. The category value t)f the module is changed only 
for this link-edit. 



CAUTION 

A program failure may result from changing the priority of 
a system module (SSxxxx module) or a compiler object 
module. Compiler object modules are modules (usually 
Sxxxxx) that are included in the load module built from 
the compiler-generated object text. .Modules for the Binary 
Synchronous Communications Adapter (SSBSxx modules) 
must remain at category and cannot be overlaid. 

Modules containing DTEs can be overlaid only if the 
associated file is closed prior to returning to the caller. 



The GROUP statement is optional; if it's not supplied, the 
Overlay Linkage Editor designs the overlay structure (see 
index entry: overlays). 
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// CATEGORY NAME-name.VALUE-nnn 



NAME-name 

or 
NAME-'name, 
name, . . name' 



Name(s) of module(s) for which the category value {priority) is to be 
changed for this linl<-edit. 



VALUE-nnn 



The new category value: 

= A module with this category value cannot be overlaid. It is 
always placed in the root segment. 

1-7 = These category values are generally reserved for system modules. 
These modules can be overlaid if necessary to satisfy mam storage 
size. Modules with these category values may only call modules 
with the same category value or category modules. I BM system 
modules have the following general category values: 

2 - Disk I/O 

3 - Tape I/O 

4 - Arithmetic 

6- Unit Record I/O 

Category values 1 , 5, and 7 have no special meaning but are available 
for use. 

8-1 24 = These category values assign overlay priorities. The lower the number, 
the less likely that the module will be overlaid. 

125 = For the Model 15, if ATTR-MRO or ATTR-MOV has been specified, 
category value 1 25 allows the module to be overlaid but does not 
allow that overlay segment to be a candidate for memory residence. 

For the Model 15, this category value assigns a special overlay 

priority. In any overlay program, routines of category 1 26 will 
be given first consideration for re-inclusion in the root area 
(non-overlay core). Generally, category 126 routines should 
be RPG mainline routines. 

This value will be treated the same as a category value of (zero). It will 
be displayed on the core map as category 0, not category 1 27, except 
when it IS assigned by a CATEGORY statement. 

128 = This value specifies that the module must be aligned on a 256-byte 
boundary. Value 128 can be used with any lower category value. 
This is done by adding the lower value to 128. For example, you can 
specify that a module have category value of 8 and be aligned on a 
256-byte boundary by specifying a category value of 136 (8 -^ 128) 
on the CATEGORY statement. Category 1 28 indicates a category 
module aligned on a 256-byte boundary. 

If an input module contains a category value of 128, the module wil 
be aligned on a 256-byte boundary even if a CATEGORY statement 
assigns a category value of less than 128. The boundary-align attribute 
cannot be changed by a CATEGORY statement, but the non-boundary- 
align (under 128) portion can be changed for this link-edit. 



126^ 



127 ■■ 
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END Statement 



An END statement indicates the end of ihe Overlay Linkage 
Fditor input and must follow the control statements and/ 
or object modules read from the SYSIN device. 



// END 



EQUA TE Statement 

Tlie EQUATE statement is used to make a temporary change 
to a reference to a module name or entry point. References 
to a module name or entry point specified in the OLDNAME 
parameter are resolved to the module name or entry point 
in the NEWNAME parameter. If a list of names is entered, 
the OLDNAME entries have a one-to-one relationship to 
the NEWNAME entries. The first OLDNAME is resolved to 
the first NEWNAME, the second to the second, etc. 

Each list must contain the same number of names. If a 
name is used as an OLDNAME more than once, it is resolved 
to the first NEWNAME it matches. Only one level of equat- 
ing is done. Consider the following statements. 

// EQUATE OLDNAME-ABLE.NEWNAME-BAKER 
// EQUATE OLDNAME-BAKER.NEWNAME-SAM 

These statements would cause references to ABLE to be 
resolved to BAKER and references to BAKER to be resolved 
to SAM. References to ABLE would not be resolved to 
SAM. 

If two modules are equaled and their entry points are also 
referenced, the entry points also must be equated 



// EQUATE OLDNAME- 



I 'name.na 



.NEWNAME- 



\'" 



name 
ame.name. 



OLDNAME-name 

or 
OLDNAME-'name, . . . name' 



NEWNAME-name 

or 
NEWNAME-'name, 



The module name or entry point now referenced in 
the program. 



The module name or entry pomt that will replace 
the referenced name or entry point in the program. 
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STORAGE MAP 

A storage map is printed unless MAP-NO is specified on 
the OPTIONS statement. The system date is printed fol- 
lowing the title line. The lieadings on the map are: Start 
Address, Overlay Number and Overlay Aiea, Category. 
Name and Kntry (for module name and entry points). 
Code Length Hexadecimal, Code Ixngth Decimal, and 
Referenced By (only if a cross-reference list included). 
Tlie Overlay Area heading lists the area each overlay is 

loaded into: U for user area, S for system area, and C for 

co-resident area. 

If the category of a module is changed, both the old and 
new category values are printed. Tlie tormat is: old, new. 

If a module is included in two or more overlays, it appears 
on the map in two or more places. If M.AP— XRLT- is 
specified on the OPTIONS statement, a cross-relerence 
list is also printed. This list contains modules that have 
external rcterence HSLs to the module names or entry 
points. 

At the end of the storage map, the total storage used is 
given in decimal, and the start control address is given in 
hexadecimal. If the program uses overlays, the non-overlay 
storage si/e is also printed. The storage si/e of an overlay 
l>rogram is always in increments of ISb bytes. The non- 
overlay storage si/.e is the exact number of bytes in the 
load module. 

The storage map can be omitted to save link-edit time 
(see Appendix C, Performance Improvements). 
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OVERLAY AREAS 

Main storage for an object program with overlays may be 
divided into four areas; root, user, system, and co-resident, 
(see Figure 3) Not all programs will need all four areas. 
The storage map indicates which overlay area each overlay 
segment is loaded into and the start address of each over- 
lay area. See the storage maps printed with the examples. 



Supervisor 



GLOBAL 
COMMON 



- Mainline Module 

Category Modules (user) 

Otiier Modules Included (if space 

available) 
■ Overlay Fetch Routine, Fetcti Table, 

and Transfer Vectors 



User I/O Dependent Modules 
(categories 8-126) 



System Modules ~~ -~ _ 
(categories 1, 2, 3, 5, 6, 
and 7. Each category in 
a separate overlay.) 



- Root Area 

■ User Overlay Area 
"System Overlay Area 



System Modules (category 4) 



User I/O Independent Modules 
(categories 8-126) 



— Co-resident Area 



Figure 3. Overlay Areas (Non-DPF System) 



Root Area 

The root area of an overlay program contains the parts of 
the program that are never overlaid (see Figure 3). The 
root area always contains the mainline module, overlay 
fetch routine, fetch table, and transfer vectors. The re- 
maining parts of the root depend on the program being 
linked. 



User Overlay Area 

The user overlay area contains user modules that call sys- 
tem I/O modules. Each overlay segment loaded into the 
user overlay area can contain modules of different category 
values. 
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If the COBOL segmentation feature has been used, the 
COBOL segments appear as overlays in the user overlay 
area. The presence of COBOL segments forces any non- 
COBOL modules that normally would have been assigned 
to the user area to the root area (category 0). 



System Overlay Area 

A system overlay segment contains system modules with 
the same category value. Each system overlay segment is 
independent of other system overlay segments. System 
modules are assigned to overlay segments solely by category 
value. A system module can only call another module with 
the same category or a category module. 

Co-resident Area 

The co-resident area is actually a part of the system overlay 
area (see Figure 3). The system aritlimctic overlay segment 
(category 4) is sometimes smaller than the system overlay 
area, if it is smaller, the remaining space is the co-resident 
area and can be used to load user modules that are 1/0- 
independent (do not call system I/O modules). If the cose 
requirements of category 4 plus the co- resident area is 
greater than the size of the system overlay area, category 
4 modules will be re-included in the root area until all 
category 4 routines are in non-overlay core, or until the 
category 4 plus co-resident area will fit into the system 
overlay area. A module can be moved from this area to 
the user area by grouping it with an I/0-dependent user 
module or by specifying AREA-USER on the GROUP 
statement. 

On the Model 15, routines of category 126 will be given 
first consideration for re-inclusion in the root area (non- 
overlay core). Generally, category 126 routines should 
be RPG mainline routines. 



ASSIGNING OVERLAYS 

The Overlay Linkage Editor attempts to fit all modules of 
an object program into the specified storage size without 
overlays. If this cannot be done, the Overlay Linkage Edi- 
tor assigns some modules to overlay segments. Figure 4 
shows the Overlay Linkage Editor method of assigning 
modules to overlay segments. The maximum number of 
overlay segments in a program is 254. Tlie first module 
encountered (either on an INCLUDE statement or as an 
object module read from the input device) is the mainline 
routine and thus part of the root. Tlie extended root 
mainline includes the mainline and all its descendants 
with each string of descendants being terminated when a 
non-category module is encountered. A descendant is 
a module called by another module. Tlie root is in main 
storage at all times and is never overlaid. Tlie amount of 
main storage available determines the amount of code 
placed into overlay segments. If the load module does not 
fit in the main storage size specified and generating over- 
lay segments would not enable it to fit better in storage, 
overlay segments are not generated. 

Througli the user entry you can use the GROUP statement 
to specify module groupings (see index entry: grouping 
modules) and use the CATEGORY statement to change 
the category of a module. You originally established the 
category of a module by specifying options to the compiler 
or assembler. 

The Overlay Linkage Editor generates an overlay fetch 
routine, fetch table, and transfer vectors for programs 
with overlay segments and includes them in the root seg- 
ment. The generated code is 1 16 bytes (127 bytes if 
ATTR-MRO is specified) plus 7 bytes for each overlay 
segment and 1 1 bytes for each overlay segment entry 
point that has a transfer vector. During execufion of the 
object program, the overlay fetch routine is called when an 
overlay segment is needed. The overlay fetch routine checks 
to see if the segment is already in main storage. If it is, the 
segment is not reloaded. This saves the time needed to 
load the segment. 
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Control Statements and 
Object Modules 




• If program fits in available storage without overlays 

• Assign category to modules that cannot be overlaid, 
(see index entry: determining overlay modules) 

• Assign root area as follows: 
(see index entry: root area) 

— Mainline module 

— Category modules 

— Overlay fetch routine 

— Fetch table entries for overlays 

— Transfer vectors for overlay modules 

• Assign system modules to overlays, (see index entry: 
system overlay area and co-resident area) 
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• Assign user modules that are called by the extended 
root mainline to overlay segments as follows: 

— If the user module, its descendant, or a module it 
is grouped with (see index entry: GROUP state- 
ment) calls a system I/O module, assign the user 
module to a user overlay segment and assign each 
descendant that calls a system I/O module or has 

a descendant that calls a system I/O module to the 
same user overlay segment. Assign descendants of 
modules in the user overlay segment that do not 
call system I/O modules to a co-resident overlay 
segment along with their descendants. 

— If the user module does not call a system I/O 
module, assign the module and its descendants 
to a co-resident area. 




Build program without overlay segments 



I 



End-of- 
Link-edit 



) 




• Compute minimum size of each overlay area. 

• Include overlay modules in the root if they fit and 
can be included (see index entry: including mod- 
ules in root). Modules are included by category 

values 1 through 126 in order. For the Model 15, 
modules are included by category values 1 26, then 
1 through 1 25 in order. If a module is included 
in the root, the transfer vector for it is eliminated 
and the fetch table entry is eliminated if the 
module was the last entry in the overlay segment. 

• If any modules were included, repeat the last two 
steps. 



I 



• Pad non-system overlays to equal lengths by combin- 
ing smaller overlays to create larger ones. 



I 



Build overlay program 



I 



Figure 4. Overview of the Overlay Linkage Editor Method of Assigning Overlays 



CEnd-of- A 

Link-edit J 
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Determining Which Modules Can Be Overlaid 

The Overlay Linkage Editor considers a module capable of 
being overlaid if the category of the module is non-zero and 
if the module is a direct descendant of (called by) the main- 
line routine (the first module named on the INCLUDE 
statement or read from the system input device) or descends 
from the mainline routine through only category modules. 
A, C, G, and H in Figure 5 meet these requirements and 
can be overlaid. 

A module that calls a module of an extended mainline 
routine (B and E are examples of extended mainline in the 
shaded portion of Figure 5) can be overlaid only if the 
module called has no direct or indirect call to an over- 
layable module. C in Figure 5 is overlayable since it calls 
E, and E does not call an overlayable module. If E called 
an overlayable module, C would have to be included in root. 

A module called by an overlay module can itself be over- 
laid (module F in Figure 5). 

Modules that do not qualify for overlay segments are as- 
signed to the root segment. Module C in Figure 6 is as- 
signed to the root segment because it appears twice in the 
program. Modules C and F in Figure 7 are assigned to 
overlay segments because each appears only once in the 
program, even thougli they do not meet the normal cri- 
teria for overlay modules. 

Link-Edit Start Addresses 

If LINKADD is not coded on the PHASE statement, the 
program is link-edited to start at the end of the supervisor 
(or at a fixed address for the Model 1 5). 



If the start address plus the length of the program exceeds 
64K, the program is link-edited to start at X'OOOO'. Using 
the System Control Program (Program Number 5704-SC2), 
the object program is linked-edited to the largest multiple 
of 2K, which allows the end address to be less than 64K. 

The link-edit start address does not affect the load address. 
A program run on other than a Model 1 or Model 1 2 DPF 
system is always loaded at the end of the supervisor, no 
matter what address it is link-edited to. A PARTITION 
statement can be used in the OCL jobstream on a Model 
10 or Model 12 DPF system to define the load address 
for programs run in level 2 (see the PARTITION statement 
in the IBM System/ 3 Model 10 Disk System Control Pro- 
gramming Reference Manual, GC21-7512, or in the IBM 
System/ 3 Model 12 System Control Programming Refer- 
ence Manual, GC21-5130). If a PARTITION statement 
is not used, a program run in level 2 is loaded at the end 
of main storage. 

Severe throughput degradation results if relocation is neces- 
sary for overlay programs. They should be link-edited to 
start at the load address. To determine the load address for 
overlay programs which are to run in level 2 of a Model 10 
or Model 12 DPF system when a PARTITION statement is 
not used, subtract the program size from the main storage 
size. For example, you can calculate the link-edit start 
address of a 9728-byte program on a 24K system as follows: 

6000 — 24K converted to hexadecimal. 
-2600 - Program size in hexadecimal. (All overlay 
3A00 program sizes are stated in sector (256-byte) 

increments on the Overlay Linkage Editor 
storage map. Non-overlay programs must be 
rounded up to the next even sector.) 

The sample program just mentioned should be link-edited 
to start at X'SAOO' by specifying LINKADD-X'3A00' on 
the PHASE statement. 
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Category 8 
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Category 8 



Mainline 



Category 
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Category 
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Category 8 



•Modules assigned to root 

Figure 5. Tree-structure of an Overlay Program 
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Figure 6. User Modules Assigned to the Root Because 
they Cannot be Overlaid 
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** Modules in first user overlay 
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Figure 7. Normal Root Modules Assigned to Overlays 
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Load Module Entry Point 



Using the GROUP Statement 



Tlie entry jxiint of a load module can be changed by using 
the ENTRY parameter on the OPTIONS statement. The 
entry point can be changed to an overlay segment. If this 
is done, the actual entry point will be to the overlay fetch 
routine to load the overlay segment. The entry point of 
load modules that reference common areas must be the 
first byte of the module. 

Overlay Area Size 

Tlie Overlay Linkage Editor assigns the smallest overlay 
areas possible. Tlie user can increase the size of the over- 
lay areas, and thereby possibly decrease the number of 
overlays, by using the GROUP statement to group modules 
into one large overlay. The Overlay Linkage Editor then 
automatically increases the size of the other overlays to 
take advantage of the increased area. Tliis reduces the 
number of overlays. 

Including Overlay Modules in the Root 



The GROUP statement is entered via the user entry to 
specify module grouping and/or overlay area assignment. 
The sequence of module names within the GROUP state- 
ment is important. The module of a group that is referenced 
from outside the group should be the first module named 
on the GROUP statement. 

Figure 8 shows the modules referenced in the following 
GROUP statements. To group modules A, B, and C in one 
overlay and D, E, and C in another overlay, the correct 
GROUP statements are: 

//GROUP NAME-' A.B.C 
// GROUP NAME-'D,E,C' 

Modules A, B, C, D, and E would be assigned to only one 
overlay if the sequence of module names in the GROUP 
statements were as follows: 

// GROUP NAME-'C,A,B' 
// GROUP NAME-'C,E,D' 



After the Overlay Linkage Editor has assigned all modules 
to either the root segment or to overlay segments, any 
overlay modules that can be included in the root segment 
without exceeding the user specified main storage size 
are included. A module can be included if it meets one 
of the following criteria: 



The GROUP statement can also be used to assign overlays 
to the user area. To assign groups AB and DE to the user 
overlay area, use the following GROUP statements: 

// GROUP NAME-'A,B',AREA-USER 
// GROUP NAME-'D,E',AREA-USER 



• The module calls no other module. 

• The module is a user module and calls another user 
module but the called user module appears in only one 
overlay segment. 



Module C would be assigned to the co-resident area. This 
method reduces the size of the user area, saves secondary 
storage (module C appears only once), and may speed up 
execution of the program (module C must be loaded only 
once). 



The module is a system module called from a user 
module and all other system modules with the same 
category, not called by user modules, have already 
been included in the root segment. 
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Fi|]ure 8. Tree-structure of Sample Program 
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MEMORY RESIDENT OVERLAYS (MODEL 1 5 ONLY) 

Memory resident overlays (see Figure 9) is a technique de- 
signed to increase the performance of large overlay pro- 
grams by allowing certain overlay segments to remain in 
primary storage after the initial segment fetch. The two 
types of memory resident overlay programs are MOVE and 
REMAP, which differ as follows: 

• When ATTR-MOV is specified in the OPTIONS state- 
ment (MOVE technique), the program retains the seg- 
ment in the resident area but executes the segment in 
the conventional overlay fetch area (see Figure 10). 

• When ATTR-MRO is specified in the OPTIONS state- 
ment (REMAP technique), the program executes the 
segments in the resident area itself (see Figure 1 1). 

To use the memory resident overlays feature, the feature 
must be selected as an option during system generation. 
However, object programs may be link-edited with this 
attribute on any system. 

The overlay fetch routine generated for the MOVE tech- 
nique is identical to the fetch routine generated for con- 
ventional overlay programs. 

The CATEGORY statement controls which overlay seg- 
ments are candidates for memory resident overlays. Any 
overlay segment containing a category 125 module is not 
a candidate for memory residence. 

With the two memory resident overlay techniques (MOVE 
and REMAP), programs larger than 48K can reside in pri- 
mary storage throughout execution if the partition is large 
enough and if the program can be link-edited within 48K. 
These techniques may improve performance for overlay 
programs that require a large number of overlay fetches. 

The REMAP technique requires that the overlay segments 
be link-edited to 2K boundaries. These overlays are loaded 
on 2K boundaries at execution time. The MOVE technique 
does not have this restriction-. For large overlay segments, 
REMAP will generally execute faster than MOVE. 

Throughput degradation for memory resident overlays pro- 
grams with RLDs will not be as severe as for conventional 
overlay programs because each resident overlay segment 
will be relocated only the first time it is fetched from disk. 



Supervisor Support for Memory Resident Overlays 

Supervisor support for memory resident overlays provides 
exactly the same function as the supervisor loader but with 
the new resident overlay techniques. It exists as a separate 
module ($@RLOD) and uses the entire partition to retain 
overlay segments after the initial segment fetch (for example, 
partitions greater than 48K). 

To take advantage of the supervisor support for memory 
resident overlays, the module must be link-edited with 
one of the OPTIONS parameters (ATTR-MOV or ATTR- 
MRO) or compiled using the ATTR parameter of the OCL 
COMPILE statement. 

An object program that is not compiled with one of the 
memory resident overlays options can be executed on a 
system that supports memory resident overlays. Similarly, 
an object program that is compUed with one of the memory 
resident overlays options can be executed on a system that 
does not support memory resident overlays. 

If a program is link-edited with a memory resident overlays 
option but it does not require overlays, the option is not 
used and no diagnostics or halts occur. 



Using Memory Resident Overlay with Communications 
Control Programming 

A program running under the communicafions control pro- 
gram (CCP) can take advantage of the memory resident 
overlay techniques if you specify additional storage for 
the program at CCP start-up. The additional storage is 
specified on the PROGRAM statement of the CCP assign- 
ment set. For more information, see the IBM System/3 
Model 15 Communications Control Program System Ref- 
erence Manual, GC2 1-7620. 
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Memory Resideht Overlay Program Execution 

Each time an overlay fetch is necessary, the supervisor 
loader checks to see if there is room for the segment in the 
resident area that begins just past the end of the last over- 
lay area. If enough room exists, the segment is loaded into 
the resident area and the corresponding overlay fetch table 
entry is modified to show the physical location of the 
segment. 

Those segments not having enough room in the resident 
overlay area wiU remain on disk to be fetched into the 
overlay fetch area as required. 

For a general schematic of a memory resident overlays pro- 
gram see Figure 9. 
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Figure 9. Schematic of the Memory Resident Overlays Program 
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Execution of the MOVE Technique 

When ATTR-MOV is specified in the OPTIONS statement, 
the segment is retained in the resident area but executed in 
the overlay fetch area. Figure 10 shows a move ot the 3rd 
resident overlay segment into the system overlay fetch area. 
This move replaces the disk I/O previously needed. 

MOVE technique considerations arc: 

1 . The ATTR-MOV memory resident overlays program 
link-edits into the same amount of storage as a con- 
ventional overlay program, but the overlays do iu)t 
have to begin on 2K boundaries (sec Example 12). 

2. The MOVE technique requires i]K)re processing unit 
cycles than the RE.MAF technique because data move- 
ment is more time-consuming than adjusting address 
translate registers. 
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// OPTIONS ATTR-MOV 
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Causes the 3rd resident 
overlay segment to be 
moved to the appropriate 
overlay fetch area. 



nth Resident Overlay 



Figure 10. Schematic Execution of the Memory Resident Overlay MOVE Technique 
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Execution of the REMAP Technique 

hacli tinie a lesidciii overla\- segmeni letch is requested by 
the oveilay leich loiitiiie. the appropriate address translate 
registers (ATRs) aie adjusted tn logically include the seg- 
meni 111 iraiislated storage. No disk I/O is required. I'lgure 
I I iliustiaics translated storage during execution. 

Rii.MAP technique considerations are: 

1 . Segnieiiis must start on 2K bi)imdanes. 

2. A program may require more execution storage than 
111 the past (must link-odit into 48Kt. 



A REMAP program can have fewer overlay segments 
than a MOVE program and may require more storage 
to execute in. 

The link-edit start address must be a multiple of 2K 
if the overlay program has RLDs; otherwise, the link- 
edit start address will be rounded down to a 2K 
b(,)undary. 

A FORTRAN program using the INVOKE feature 
cannot be used with a memory-resident overlay. 
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MJ Always active 

r 2j A system overlay that does 
not fit in resident storage or 
contains a category 125 mod- 
ule and that is being executed 
in the conventional overlay 
area 

(3) , ( 4j A resident overlay segment 

lor either the user or resident 
area where execution is with- 
in the resident area itself 



!© 



// OPTIONS ATTR-MRO 



Causes the execution of 
the segment in the 
resident area itself. 
Address translate 
registers are remapped. 



Figure IT Schematic Execution of the Memory- Resident Overlay REMAP 
Technique and Overlay Fetch Routine 



Examples 



EXAMPLES 1 THROUGH 5 

Tliesc five examples show the OCl slatements and Over- 
lay Linkage Editor control statements used lo hnk-edil 
five programs. Tlie ni)tes with each example explain the 
purpose of the control statements in each loh. 



Example 1 




1//. fj 



V/. HUK 

■//. O.pTJOAS. .L/|PA.C.K-R,l,ArTf?-CPR?il pVfI -?/7i ' - ^ 

■''/\ END 






a: .^/^.nEi-!tW'ORK,jU,H.IT-!Fl,P/^CK-.F,l|F.l,Fl.,.TRAC,^^S-10: rAr^xl/^K,_o'.:5 "^ 

r.HAPE; NA^M^EI- TES:T5k); -UHlT- Rl ,RETAliN-P 
OPTJ 0^,5. .UPA.C.K- Rl. , At If?- CP R X EVE L - Z4> 
I.NCI^Um NAiHE-TEST¥£f,ljNIT-A:i 

END, ' ■ 



,jL.OC;ATION-36;«t,.RE'TAI,N 

■ i ■ ' i 



/?ETAIN 



Notes on Example 7 

9 The Overlay Linkage Lditor is loaded fiom the fixed 
pack on drive I . 

Q The SSOURCL file ol ten tracks is allocated on the 
fixed pack on drive I starting at track number ,i5(). 
This is a scratch file. 

Q The SWORK file of ten tracks is allocated on the 

fixed pack on drive 1 starting at track number 360. 
This is a scratch file. 

Q Lxecution of SOLINK (last OCL card) is started. 

^^ The output load module is geiieralcd as a perinaneni 
entr> in the object library of the removable pack on 
drive I under the name TLST50. The start address 
is the end of the supervisor plus .X'()200'. 



^J L'ser modules can be found on drive Rl. This pro- 
gram is a checkpoint restart program. The level 
number is 20. 

^0 The mainline routine for this program is an object 
module in the object library t)f the removable pack 
on drive I under the name THST40. 

^J hid of the Overlay Linkage liditor input. Automa- 
tic (werlays are generated if needed 
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Example 2 



o 

o 

o 



// LOIAiD ^LI 

// PHAiSiE UAfi 
' / / IW'CILiUiDJE fl 



EJ-BliUlE' 
AlMlE-BiLJU 



\t 



S Car 






\ 



B.'ii'm\T-'fd 



E c.crd; I) ..: i ;;;;:. T; ;; ;^ 



// .£QU ■ ■'-' ' ■' •-'■■■ 

/ / END 



fljT.E _ ^fV€^WlNf:fl j^E- RjE P;, OL 



- f ■ 
• i - 






■14- 



ov 



t - u 



+-1 f 



+-[ 



I — 



j 4 t - 

4-^ + - 



4-1 i-i 



... .[._;._ 

-44.-^.-. 



-TJ 






A/ofes on Example 2 

^P The Overlay Linkage Editor is loaded from the 

removable pack on drive 1 . This pack is now the 
program pack. Because no file statements are 
given, the Oveilay Linkage Lditor fnids from 10 
to 30 tracks o^i work space on either LI or Rl. 

(^ The output load module is a temporary entry in the 
ohjecl library of the program pack (see note I ) un- 
der the name BLliL. Look for user modules on the 
progiam pack because no OPTIONS card is given. 
Ttie mainline routine for this program is BLUE and 
is located on I- 1 . 

1^ One of the nu)dules required for this job is in card 
torm. The name of the module is picked up from 
the module name h^SL entry on the S card. 

O Lor this link-edit the category of module WHITE 
is changed to a value of 20. WFIITE is included by 
-ALTOLINK. 

^J The reierences to YELLOW in the object module 
are re|)laced by RED in the load module. 
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Example 3 



o 

o 

e 

o 
o 



9a 



(LiOlfl 

.R:u!N 

0\?\l 






iiio 



C a r d 
£ ]c*a!r^ 



// £iQV 



Wotj 

MfliMlE 



GiORY 

VE 'OL 






UfJllY: 



£l'K'^ijI;-:R.iu 






fV r - 



rr>^ 



yii-ziidiiFji, 






te^jR;!;'^ 



T.R 

1;. 



, p 



:jfl!C 



,-_--+- 



t 1 






DIN/;/) Mif-"' 



fl, a, cj'Vw'E'Wii^^l/^f'- 









■t-i t- 



..1 1 

-+ 1 



■+ t 



Notes on Example 3 

O SWORK and SSOURCE are allocated on the two 
packs on drive 1 . SWORK will be ri^ht on top of 
SSOURCE. 

Q Tlic object code is constructed so that the program 
can run in a 12.5K partition. The entry point 
WHITE IS the start control address. Only messages 
are printed. 

^^ Tlie mainline routine tor this program is in card form. 
Tlierefore, no INCLUDE card is used for it. If a 
mainline is in card form it must be the first card 
deck read. 

^y For this link edit the category of both modules 
RED and GREEN is changed to a value of 55. 

^^ If more than one module category value is to be 
changed, more than one CATEGORY card can be 
used. 

^^ The references to module names or entry points A, 
B, and C are replaced by X, Y, and Z, respectively. 

\0 The references to module names or entry points D, 
E, and F are replaced by Q. 



■mwu- 



r\f\ 



' ' ' I 
[■-*-• -f- 



r t 



m 
m 



[ r -: 



n r- 
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N!-!Si 
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Example 4 (Model 15 only) 



i// ^m 



' 48 -in 50 bl S7 =>3 !ia 55 56 5? 58 59 60 b1 63 63 G1 65 66 67 68 69 70 71 73 
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^_. CATiEjGD:Pi^ 
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Example 5 
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Notes on Example 4 
O SWORX and SSOURCE are allocated on a 5445. 



A temporary entry is cataloged in the object library 
on the program pack under the name of the module 
included. 

The overlays, if necessary, are constructed so that 
AA, BB, and CC are in main storage at the same 
time. 

The category value of subroutines AA, BB, DD, and 
EE is 30 for this link edit. 

Routines in the same group do not need to have the 
same category value. By giving the module a lower 
category value, its chance of being in the root seg- 
ment increases. 



Notes on Example 5 

^m The work area is assigned by the linkage editor. 

^M A load module is punched and no library entry is 
made. 

yy A cross-reference list is printed on the storage map. 

^^ If PGMA is assigned to an overlay, it will appear in 
the user overlay area. 

^S The only thing needed is an R module. The defaults 
are taken. 
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EXAMPLES 6 AND 7 

These two examples of the same program show how the 
overlay structure of a load module can be changed by 
varying the input control statements. Both examples 
include the input control statements, the storage map 
printed by the Overlay Linkage Editor, and a graphic rep- 
resentation of the overlay structure. Figure 1 2 shows the 
callmg sequence of the modules within the program 



Example 6 

Two overlay load points are shown on the storage map 
(START ADDRESS heading). INIT (co-resident area) 
has the same load point as the system overlay area because 
it has no references to system modules and no category 4 
modules appear in the program. A reference to a cate- 
gory 4 module does not disqualify a module from the 
co-resident area. 



MULT4 and DIV4 are assigned to the root area by the 
Overlay Dnkage Editor because of their low category 
values and small size. FINAL is assigned to the root area 
despite its high category value because it can be placed 
there without causing the program to exceed its main 
storage size. Normally GET6 or PUT6 would be included 
in the roo? segment before FINAL because of their lower 
category values, but the Overlay Linkage Editor does not 
include any system modules that are called by user modules 
until all system modules of the same category that are 
caUed only by other system modules are in the root seg- 
ment. In this example, $$LPRT and SSMFRD will not 
fit. 



MAINL 



1 r 



1 — n r 



D1V4 INlT NAME ADDRSS LOC INV BILL SHIP ITEM FINAL Mu'lT4 Sr'eAD 



MULT4 



DIV4 



GET6 



SMFRD 



SWRITE 



PUT6 

I 

$LPRT 



Figure 12. Calling Tree-structure of Modules Linked In Examples 6-7 
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Example 6 



1300 



// Ln^D .01 IMK.F 1 

/■/ MIF MA>l[-f5GiJ«CE,UMl T-ci ,p4CK-f IFIM,RETAIN-S, TRACKS-^ 

// flLf NAMt-lWURK ,UiMl T-Fl ,PACK-E IE IFl ,RE TAIN-S,TRAr,KS-5 

// RUN 

// PHASE NAMt-QLSMPL ,UNI T-F 1 

// iJPTlONS MAP-XRtF,CnRE-SK 

// CATfGcJkY NAME-" "ULT'i.UI V'.' , VAL'IE-"* 

II CATFO'JRY NAMfc->GE16, PUTf,' ,VALUE-4 

// LATtGlJRV NAME-ShKl TE, VAL'Jt-135 

// CATFGilRY NAME-SRFAD, VALUE- na 

// CATtGiJRY NAME-NAMfc , VAL 'JE-?0 

// CATFCiJRY ,MML-AlJJR5S, VALUE-?! 

// CATFGtlRY NAMt-LOr., VALUF-2? 

// LATFgIjKY NA'lt- INV , value-? 1 

// CATFGIJRY NAMt-tULL .VALUF-?*. 

// LATtG'iRY .MAMt -SHIP,VALUf-?S 

// CATFGURV NAMf -I TEM, VALUE-?6 

// tATEGljRY NAME-' IN IT ,F IMAL ■ ,VALUE-'J0 

// LNO 



1BFB 



1E00 



2400 



2700 



Root 



OVLFRTN 



User 



System 



User — Overlays 1 through 8 
System — Overlay 9 
Co-resident — Overlay 10 



Co-resident 



OVIFLAY LINKAGE KDITHR CORF USAGE MAP AND CROSS REFERENCE LIST 



11/23/71 



START 
AUORfc SS 

L 30 
18?0 

1 B6C 
IRAD 
IBEB 
IFOO 
2?00 

lEOO 
2?00 

lEOO 
2100 

IFOO 

2 100 

IFOO 
21U0 

IFOO 
2200 

lEOO 
7 100 

UOO 

?'t;)o 

2'i^'t 

?'^n 

2579 
2'.00 



OVERLAY CATEGORY NAME AND 

NUMBER AREA FNTRY 



CODE LENGTH REFERENCED 

HEXADECIMAL DECIMAL BY 
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6 
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6 


ItLPRT 


6 
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SHIP 
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78 
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ADDRSS 
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SHI P 


ADDRSS 
ITEM 
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MAINL 
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ITEM 
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OlFA 
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SREAD 






00 3 A 
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PUT6 
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GET6 






oono 


208 


MAINL 







INV 



BILL 



BILL 



BILL 



BILL 



(ILIOO 1 

OLIOI I 

;)L102 I 

OLIO', 1 



rut lOTAL CORF UseO HY OLSMPL IS 5120 DECIMAL 

THE START CONTRilL AL))RESS OF THIS MOOULE IS 1300. 

THE NON-OVERLAY CORE SUE IS 9<.66 DECIMAL 

r ITAL NUMBER OF LIBRARY SECTORS REOUIREO IS 55 

NAMF-rLS"PL,PACK-FlFlFl,UHIT-Fl,REIAIN-T,LItlRARY-0 
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Example 7 

This example shows three overlay load points. Overlays 
1, 2, 3, and 4 are in the user area. Overlays 5 and 6 are in 
the system area, and overlay 7 is in the co-resident area 
(user module in the system area). GROUP statements 
were entered to increase the size of the user overlay area. 
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MAINL 
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PUT6 
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THE TOTAL CURE USFJ BY IHiMPL IS j6 12 [lEClMAL 
IMF START CONTHIJL AUDRFSS 1)1- THIS MdUULE IS 1300. 
THE NON-OVERLAY CflRt SUE IS 9466 DECIMAL 

lOlAL NUMHtR OF LIHRARY S F C T OR S REUJlRtO !S 51 

NA-H—tlLSMPL , PACK,-! ir IF I ,0N1 T-F 1 ,Rf TA I N-I ,1 I BRARY-O 
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EXAMPLES 8 THROUGH 11 

Tliese four examples show how the overlay structure of a 
program can be changed by varying the input control state- 
ments. The changes result from varying the category values 
of modules and varying the main storage size. All four 
examples show the input control statements, the storage 
map printed by the Overlay Linkage Editor, and a graphic 
representation of the storage map. Figure 13 shows the 
tree structure of the program. 



ROOT 



ABLE 



BAKER 



JAKE 



KING 



CHARLY DOG EASY 



LOVE MIKE 



EASY 



Figure 13. Calling Tree-structure of Modules Linked in Examples 8-11 
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Example 8 

All modules except ROOT, BAKER, and KING are given 
overlay category values. Because no system modules 
(category values 1-7) are present, only one overlay area 
IS assigned. Any module assigned to an overlay segment 
must be assigned to the same segments as its descendants. 
Because ABLE calls CHARLY and DOG (through BAKER), 
these three modules are assigned to one segment. Likewise ' 
JAKE calls LOVE and MIKE (through KING) and is assigned, 
with them, to the second overlay segment. EASY would 
have been assigned to both segments, but space was avail- 
able in the root so EASY was included in the root segment. 



// CALL ULINK.Rl 

XX LOG PRINTER 

XX N0HAL7 

XX PUNCH MFCU2 

XX LOAD SOLlNKiFl 

|^^AMt-tSr)URCE,REIAIN-S,^RACKS-2 5,PACK-FlFlFl,UNIr-Fl 
NAME-t^nRK,RETAIN-S,T«ACKS-2S,PACK-FlFlFl,UNir-Fl 



1300 



2B00 



2C00 



Root 



XX FILE 

XX FILE 

XX RUN 

// RUN 

// PHASE NAME-RIZZ I.UNI I-Fl 

// OPTIONS MAP-XREF,UPACK-Ri,CnRF-niK 

// INCLUOE NAME-ROriT.UNI T-Rl 

// CATEGORY NAME-'AHLE , JAKE' , VALUE-a 

// END 



OVLFRTN 



Co-resident 



Co-resident - Overlays 1, 2 
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OVERLAY LINKAGE EDITOR CORE USAGE NIAP AND CROSS REFERE 



NCE LIST 
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START 
ADDRESS 

1300 
130A 
IROO 
1B0«, 
IFOO 
2008 
2300 
250A 
2R00 
2C00 
2F0A 
2F28 
2F34 
3728 
3A31 
2C00 
2C0A 
3000 
310C 
3800 
3HDC 



OVERLAY CATEGORY NAME AND 



NUM8FR AREA 
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0,8 

37 

37 

0,3 

37 

37 



ENTRY 

ROOT 

ROOT 
3AKER 

BAKER 
KING 

KING 
EASY 

EASY 
OVLFRTN 
ABLE 

ABLE 
CHARLY 

CHARLY 
DOG 

DOG 
JAKE 

JAKE 
LOVE 

LOVE 
•1IKE 

•IIKE 



CODE LENGTH REFERENCED 
NEXAOtCIMAL DECIMAL BY 



0800 


20',8 






O'iOO 


10?^ 


ABLE 
ABLE 




O'.OO 


1024 


JAKF 
JAKE 




0800 


20'.8 


BAKER 


KING 






BAKER 


KING 


00C4 


196 






0328 


8 08 


ROOT 
ROOT 




U800 


2048 


BAKER 
BAKER 




0800 


2048 


BAKER 
BAKER 




O'iOO 


1024 


ROOT 
ROOT 




0800 


2048 


KING 
KING 




0800 


2048 


KING 
KING 





OLIOO 1 

OLIOI I 

0L102 I 

OL104 I 



THE TOTAL CORE USED BY RIZZI IS 11520 DECIMAL 
THE START CONTROL ADDRESS OF THIS MODULE IS I 30A 
THE NON-OVERLAY CORE SIZE IS 16168 DECIMAL 

TOTAL NUMBER OF LIBRARY SECTORS REQUIRED IS 67 

NAME-KIZZI ,PACK-F1F1F1,UNIT-F1,RFTAIN-T,L18RARY-Q 
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Example 9 

All modules have an overlay category value (non-zero). 
Because there are no system category values (1-7), only 
one overlay area is assigned by the Overlay linkage Editor. 
Only two overlay segments are possible because each call- 
ing module must be in the same segment as its descendants. 
Module EASY could be given a category value of so it 
would be placed in the root rather than in both segments. 



1300 



1CO0 



// 

XX 
XX 
XX 
XX 
XX 
XX 
XX 

// 
// 
// 
// 
// 
// 
// 



CALL 
LOG 

NOMA 

f>UNC 

LUAD 

E ILE 

PILE 

RUN 

HUN 

PHAS 

'JPTI 

!NCL 

CATE 

LATE 

tND 



JLINK ,R 1 
PRINTER 
LT 

H •^FCD^ 

tiTL INK.E I 

NAML-$SaURCE,RETAlN-S. TR ACKS- 25 , PACK-F IF IF I , JNIT-Fl 
NA»«E-t^ORK,RETAI^J-<i, TRACKS- ?5 , PACK-F IF IF 1 , UN 1 T-F 1 



E NAME-R IZ ,UNI T-F I 

UNS ^AP-XREF ,UPACK-R1 ,CTRE-H10K 

UUE NAME-ROOT , UNI r-Rl 

bURY NAMt-'BAKER,K,lNG' ,VALU6-8 

UORV NAME-" ArtLE, JAKE' , VALUE-a 



3C00 



Root 



OVLFRTN 



Co-resident 



Co-resident — Overlays 1, 2 



OVERLAY LINKAGE EDITOR CORE USAGE MAP AND CROSS REFERENCE LIST 



START 

ADDRESS 

1 300 

1 IDA 
IBOO 
ICOO 
IFOA 
!F2B 
IF2U 

? ^^a 

?B28 
?E31 
1128 
1532 
ICOO 
ICOA 
2000 

2 lOB 
2'VOO 
250C 
2C00 
2C0C 
1^.00 
360A 



OVERLAY 
NUMBER AREA 



EGORY 


NAME AND 




ENTRY 





ROOT 




ROOT 




OVLFRTN 


0, 8 


ABLE 




ABLE 


0,8 


BAKER 




BAKER 


17 


CHARLY 




CHARLY 


17 


DOG 




DOG 


37 


EASY 




EASY 


0,8 


JAKE 




JAKE 


0,8 


KING 




KING 


17 


LOVE 




LOVE 


37 


MIKE 




MIKE 


17 


EASY 




EASY 



CODE LENGTH 
HEXADECIMAL DECIMAL 



2048 



REFERENCED 
BY 



OOFO 


240 






0128 


808 


ROOT 
ROOT 




O'.OO 


1024 


ABLE 
ABLE 




OdOO 


2048 


BAKER 
BAKER 




0800 


2048 


BAKER 
BAKER 




0800 


2048 


RAKER 


KING 






BAKER 


KING 


0400 


1024 


ROOT 
ROOT 




0400 


1024 


JAKE 
JAKE 




0800 


2048 


KING 

KING 




0800 


2048 


KING 
KING 




0800 


2048 


BAKER 


KING 






BAKER 


KING 



OLIOO I THt TOTAL CURE USED RV RI7 IS 10496 DECIMAL 

OLIOl 1 THE START CONTROL ADDRESS OF THIS MODULE IS IIOA. 
UL102 I THE NON-OVERLAY CORE SIZE IS 16168 DECIMAL 

0L104 I TOTAL NUMBER OF LIBRARY SECTORS REQUIRED IS 75 

NAME-R! Z ,PACK-F1F1F1,UNIT-F1 , RE T AI N-T , L 1 BR AR Y-0 
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Example 10 

Module liASY is assigned a category value of 2. Because 
the Overlay Linkage Editor assumes that categories 1. 2. 
3, 5, 6, and 7 are system I/O modules, modules BAKER 
and KING are I/O dependent and are assigned to user 
overlay segments. The remaining lour modules are I/O 
independent and are assigned to co-resident overlay 
segments. 



1300 



2228 



2400 

// CALL OL INK ,R1 

XX LUG PRINiTtR 

XX NQH4LT 

XX PUNCH MFCU2 

XX LOAD tllLINK.f-l 

XX f ILE NAMfc-tSnUKCF.Rf TAIN- S.T.iACKS-X',, PACK-flUFl, UNI T-Fl 

XX FILF NA'>1F-twnK<,RFTAlM-S,TKACK5-?5,PACK-FlFlFl ,UNI r-Fl 

// RUN 

// PHASl NAMt-t V.'.UNl T-F 1 2800 

// UPIIUNS MAP-XKEF,cnRt-H7K,UPACK-Rl 

// INCLUDE NAMF-r<U!IT , UNI r-Rl 

// CATEuURy NAME-' [)AKfck ,M NC , VALUE-d 

// CArEL,U«r NAME -EASY, VALiJF-^ 

// END 



Root 



OVLFRTN 



User - Overlays 1, 2 
System - Overlay 3 
Co-resident - Overlays 4 through 7 



User 



System 



Co-resident 



3000 



UVERLAY LINKAI.E EDITOR CURE USAoE MAP AMD CR )SS RFFFRrNCE LIST 



07/ I b/Tl 



STAR T 


ADDRESS 


1 30 


1 JO A 


1 B 


IFOA 


IE.? 8 


IE )? 


^?^ti 


2<.0U 


2 '.Ob 


?'.0 


?bOH 


2 a u 


2A0A 


2 80 


2 HOC 


2«00 


2BU9 


2S00 


2'50C 


2 SOD 


280C 


ILluO I 


)H01 I 


JL102 I 


TLIO'. 1 



U V E R L A Y 
NUMllFR AREA 



1 


U 


2 


U 


J 


s 


'* 


C 


■) 


c 



Teg TRY 


N A M f-- AND 




FNIRY 





RU'IT 




RUJI 


1 


AdLf 




A'iLE 





JAKF 




JAKE 




UVLFRTN 


.s 


BAKFR 




'lAKEH 


> 8 


Kl NG 




K I NG 


iT ,? 


EASY 




EASY 


i 7 


CriARLY 




CHARL Y 


17 


JUG 


( 7 


D Uu 
LOVE 




L 'IVE 


i 7 


M 1 KC 




«! KE 



CllDF LENGTH RFEFRENCED 

HEXADECIMAL DECIMAL RY 



0)00 


20'.8 






t2R 


808 


ROUT 
ROUT 




J'fOO 


102-^ 


R )'JT 
RD jT 




J0F2 


2<.2 






U'.OO 


10 2'. 


A8LF 
A8LF 




OiOO 


102'. 


JAKF 
JAKE 




OH 00 


2D'.8 


8AKER 


KING 






BAKER 


K ING 


1 J « 1 


20'.8 


8AKFR 
8AKFR 




'J 8 00 


2D'.H 


BAKER 
BAKER 




8 


2 0'.8 


KING 
K 1 NC 




o^o^ 


2 '.8 


K ING 
K ING 





THE T!11AL CUKE OSID BY t \l ' 
THE START uUNTkUL ADDRESS UF 
THE NON-^^VERLAY CIRt SI7t IS 
TUTAL NUMBER (If LMRARY SECT' 
NAME-EV2' , PACK-FIF IF 1 ,UNI T- 



1 S a,?/, DEC 1 MAL 
THIS MUDULF IS IBOA. 

I'llO.R DECIMAL 
RS RE.JUIRED Is 72 

Fl , Rcta IN-T ,L 1 bRARY-U 
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Example 11 

All modules except ROOT have an overlay category (non- 
zero). Because BAKER and KING caJl a system module 
(EASY), they are assigned to user overlay segments. Mod- 
ules that call BAKER and KING (ABEE and JAKE) are 
put into the same overlay segment as the modules they 
call. Modules that do not call system modules are assigned 
to the co-resident area. 



1300 



Root 



1B00 



1D0G 



// CAL 

XX LUG 

XX MOH 

XX PUN 

XX LOA 

<X F IL 

XX E 1 L 

XX K u N 

// i<UN 

// PHA 

/ / ;J P I 

// 1 NC 

// CAT 

// CAT 

/ / END 



L JLIMK.RI 

P R I N r t R 
AL T 

CH Mft.U^' 
D iQLlNK.Fl 

F NAvt-lsr)URCE,RETAI\|-S,r<ACKS--'S,PAr. K-FlFlFl,jNir-Fl 
f NAMF-t«/|-)RK,BFT4IN-S,TRACKS-?S,PACK-FlFlFl,u-4ir-Fl 



SE NAMt-E V?«,UNI T-F 1 

ri\|S IJPAC^-R^,MAP-XREE,C5KL-T'>^ 

LUJF \.AME-R10r,UNlr-Rl 

EGURY .•4A>1t -'AHLE , BAKFR, JAKE .KING 

FGJRV NAME-EASY, VALUE-,' 



.VALUE -8 



2500 



OVLFRTN 



User — Overlays 1, 2 
System - Overlay 3 
Co-resident - Overlays 4 through 7 



User 



System 



Co-resident 



JVERLAY LINKAGE tUlFUR CTRE USAGE ^^AP ANU CROSS REFERENCE LIST 



START 


ADORESS 


1 )00 


1 lUA 


IROO 


1000 


200A 


202 8 


202D 


100 


IDOA 


2100 


2208 


2S00 


270A 


2500 


2')0C 


2500 


2809 


2 50 


250C 


2500 


250C 


ULlOO 1 


JLlOl I 


UL102 I 


OLIO'. 1 



UVFRLAY CATEGORY 
NU'-IDFR AREA 



J. 8 
,? 

.a 

0.8 

ir ,2 

37 
3 7 
J7 
(7 



I 


U 


1 


U 


2 


U 


2 


u 


i 


S 


't 


c 


5 


c 


'. 


c 


7 


c 



NAME AND 
ENTRY 

RJTT 

RflUT 
OVLFRTN 

ABLE 
-lAKEK 

BAKER 
JAKE 

JAKE 
K I NG 

K ING 
EASY 

EASY 
CHARL Y 

CHARL Y 
)0G 

DOG 
LOVE 

LflVt 
M KE 

•il KL 



CUOF LENGTH REFERENCFU 

HEXAOECI'^AL OECIMAL BY 



0108 


264 






0328 


8 08 


ROOT 
ROOT 




COO 


1024 


ABLE 
ABLE 




OitOO 


1024 


RflHT 
RIKIT 




0400 


1024 


JAKF 
JAKE 




0800 


2048 


BAKER 


KING 






BAKER 


K ING 


0800 


2048 


BAKFR 
BAKER 




0800 


2048 


BAKER 
BAKER 




0800 


2048 


KING 
KI NG 




0800 


2048 


KING 
KI NG 





THE TOTAL CURE USEO RY tV28 IS 665(. OFCIMAL 

THE START CONTROL ADDRESS UE THIS MODULE IS 130A. 
THE NON-OVtRLAY CORE SIZE IS 14168 DECIMAL 

TOTAL NUMBER OF LIBRARY SECTORS REQUIRED IS 72 

NAME -FV 28 , P AC K-F IE 1 F 1 , UN I T-F 1 , RE T A I N- T . L 1 BR AR Y-O 
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EXAMPLES 12 AND 13 



Example 12 



These two examples show the same RPG program link-edited 
with both memory resident overlay techniques. Note that 
the ATTR-MRO program requires 2K more to execute in 
than the ATTR-MOV program. 



Thisexample showsa link-edit of an RPG program requesting 
the memory resident overlay MOVE technique (ATTR-MOV). 
This technique can also be requested by using the COMPILE 
statement at compile time. The link-edit map for this tech- 
nique looks exactly like a conventional link-edit of the 
program. 



// LL4D tLL !N^, t-i 

// «U^ 

// iipii r., '•t-Ki^.'^»f-'ts,»m-«ov_^OPTIONS Statement request 

// tND I 



for MOVE technique. 



tali 
1 aHf , 1 



1 SS 

1 ^j'i 



The overlay segment containing 
this module will not be a 
candidate for memory residence. 



UVtRL^y LENi^flCt tDITOR 



& 



START 


QV ERLAY 


CATEGORY 


N AM E A N U 


CODE LE N 


G TH 


AOCftESS 


NU-^BEP AREA 




ENTRY 


hEXADtC I »^AL 


OECI f-AL 


tooa 






GLOBAL 


05A0 


U4C 


^5A0 






COMMON 


C578 


UOC 


-.CQO 







SAMPLE 


C12« 


29b 


-^D.'o 







S«RT02 


ClBl 


't3 i 


■* EDy 







i»MISC 


0018 


24 


tiiFl 







J#IPCR 


coto 


S6 


^ EP/ 






$qOE69 






-ff^l 







$*OPCR 


OOBQ 


176 


tft)^ 






$ a OF 19 






SOOl 







S#CONO 


C013 


IS 


^ou 







iSCQNl 


COl / 




')02B 







t «C0N2 


COl? 


1 8 


503D 







S#C0'^3 


C03'* 


S? 


^071 







ISP&AR 


0071 


1 1 1 


50E2 







1 JPG DC 


Z'*b( 


11 11 


353-^ 




2 


StSRfli' 


OC Hi" 


1 3C 


^5BB 




2 


iS SR 'JA 


c c 2 ;> 




^-^El 




2 


ti jK t( 


OClL 


2 -^ 


b'>fcl 






.(■^ Si^l : 






b5F2 






\)^ S~ 1 r 






bbF^ 






L^M S-v : ►< 






55ED 




2 


ti SkiJI- 


roic 


2 e 


5619 




2 


1 I'l'J Sf 


(, C'.b 


7G 


565F 




^ 


i$ SK4P 


1 ij i -^ 




^69A 




12c 


l 11NP T 


CCj'j 


? 1 ''. 


572F 






i a 108U 






e. 73b 






t a 1 ^. 9 i, 






5 76 3 






t a i OC 1 






b7l6 






tal074 






571 i 






i L 1 G 7 1 






!)710 






t a IC6( 






372? 






t « 1 C f; 5 






572B 






talC^'^ 






376^ 




28 


$#1H01 






5777 




28 


S«lh04 


( LC -) 




5 77P 




29 


S«EXPT 


. „ 3-. 




5763 




28 


$ #0 H 1 5 


: c -J 


I . 


576F 




28 


* #0 H C ? 


C G CG 


1 ,' 


57CB 




12fc 


iCIFLU 


r... '-1 


L .' '. 


57t'. 






$51326 






5830 






saus'. 






5846 




93 


SiKCLGS 


CCi'-) 


", ■ 


Se'tO 






tai6F? 






^858 






$al7C3 






5862 






SS17C7 






5071 




126 


t#0OUT 


GO 7^ 


1 / ' 


58EC 




28 


$#0H05 


cua. 


U 


58r8 




12t 


$«T0UT 


3.) 


fU 


5935 




126 


$#LRQF 


C G 2 '* 


■.t 


5959 




71 


S*OFOh 


G G 2 4 


■^ J 


5983 




126 


I #R C I D 


CC'.'i 


1 ' - 


5989 






$iion3 






59D7 






i a 1 1 2 1 






5 AOE 






$ill5S 







::::;,.^: :; 


■ ■. 125 ifl --r. 
I J / t i ■"' ■ M 


G2A T 


f-r C 


o 'lO y J 


;■■ fcii \ |[> 


1 ■::' ? 


"■ 9 


:G^; 


i 1 (" ^J M ■ 


I. I, 1 t 


.-■9 
1 ^'. 
1 '.S 


i'^iD: : 


1*^ '.k - ,1 
f fc t a "■ M i : 
6 i t L ^ ■' T 




2S9 
2^0 



J® 



Gi, 


"- 


i 


11 ij:' ,4 I 
V7 ii.t'..A(. 


^ 


L .1 ) - I / 
I 7^ ^71 


t:'^ 


^\ 


1. 


1 ) / 1 «L ■'G 


e 


":a>j 169 


L 1 . , [ 
L IJ L 1 
L 1 G' i 
L L ) -t I 


1 Mt T 
1 ■!; ■) 
r H 1: N 
I ..r AL 
"n A ■^ t. - 


,r al 

G JMrit - 


■J. i S : 1 E Y ^ ■ V ^ 

v! -<:U. AiJlJ-i t S S .)E i 1- 

LAY COkL il/- IS 

i.t 11 :;kA- Y M G Ti.R 
t'AC- - E IE U 1, JN 1 l-( 


, U24C 

' '. " J Gl 

i - C '. f 1 

k ^ ■.. Ij [ 4 f 

.'^; lA IN- 


) b G i ^ A L . 

1 ^ '.(.c:.. 
r 1 -^A L 

, L 1 -* N A '. V - r- 



I Segments do not have to start on 2K boundaries (la to If). 

\ This overlay segment will not be a candidate for 
resident storage because of the category 1 25 module. 

\ Core used is less than REMAP. 
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Example 13 

This example shows a link-edit of the same RPG program 
used for Example 12 requesting the memory resident over- 
lay REMAP technique (ATTR-MRO). 



// LOAD $CL INK, P 

// HALT 

// RUN 

// CArecony NAMe^^ttp glc, sspgaco, value- u« 

// I-PIIQNS JrTR-M«O,»(AP-XREF,CORF-10K 

// PHASE SAME-REMAP, U"JIT-F1, RETAIN-T 

// INCLUOt NAML-S AMPL e, UN IT-E^I 

// tND 



'OPTIONS statement request for REMAP technique. 



•"Overlay segments containing these modules will 
not be candidates for memory residence. 



Rl Ar LINKAGE EDITOR C:]PE USAGE MAP ANi) C RG 



REEERENGE LIST 



i NM I SG 
srilPGiJ 






tSlCUNC 


c 


i.«CJNi 1 





t #CGN ? 





trtCON-^ 


G 


itP&Ab 


'^ 


tSPGDC 


i/t 


$ # INP T 




taicyo 




tilGS^ 




i a I OC I 




SalC?*. 




ia 1C71 




S S 1 f E 




s a 1 c e 5 




Saioe9 


2b 


$<* IHCI 


Zb 


$«*IHO'* 


\Zt 


$»TCAL 


c>^ 


$«SRFC 


2S 


tSSRl-D 


iO 


S « SR F t. 


Jl 


t « SR F F 


"^^ 


SSSROC 


-3 


SftSiiCl 


J 3 


i»SRC^ 


i-- 


$ « SR C "-^ 


33 


i SSRO^. 


33 


$ SR G b 


126 


S«OCAL 


33 


SttSR C6 


2y 


$«EXDT 



GEJUE LE NG iM 
XAOEG 1 MAL l)E{ I 

CSAO \',u 

C 1 . ,1 



OOBO 



G0I3 
CCi7 



CO 71 
OA S7 



C008 
0008 
COG 7 
0099 
0099 
0099 
0099 
0099 
0099 
C099 
C099 
0099 

00 7F 
012E 

01 OE 
C03"> 



96 
1 76 



1 13 

ill 1 



1 99 
153 
153 
153 
153 
153 
153 
153 
153 
153 
iZl 
3 02 
270 
52 



$*CLOS 
$S16F? 


CQ2B 


43 


ill 7C3 






$S17C7 






S»GROT 
t»OOUT 

$«nHC5 

t WTQUT 


C03D 
C07Ei 
CCOC 

CO 3.1 


61 

123 

12 

61 



1 » S R 1 
$ h S R ( I. 



£»CF L ') 

i « I pr. K 

SAmpl e 

$#SR1? 

t#Trui 

$ « i F L L> 
S«RT02 

t«JPF N 

t # L R CI F 



1« SROU IW :> R I- h 

s* ^'^ol iwc ; of 

%t r ■ 111 itf f I -s 

to^-fLij iaFrn: 

i«RTj2 

l#SR01 t«SP)3 

taSPt-c sarMis 



1#SR03 $»SR02 
t«Sr,FF $«SRFO 

$# DTfiL 

s « n p c R 



ttfPPf N 
ill* !NPT 



iSSROi. J#SR03 
J«SRFF ItfSPFF 



$#rH05 

t» I K FT 
$« I H03 

$#T(:UT 



« UOUT 

« C HO ? 

« r F L D 



taOPFN 



Itf FXPT 



$«rH02 



S#r'FCF 1#FX 



$#TOUT 



SSCLGS JWUPFN $«TCAL 



$*fCLCS 
$i«l.RCF 
$«i:CUT 



t#cPCR t#rpcp 

t#SP05 $**SRO'» ti«SR03 i#SR02 
t#SP0O i#SRFF StfSRFt twSRFC 



*«TCAL SSLCiL 

$#nH15 $#CHO^ 

S«DCUT 

SSTOUT 

i^LROT 

tSMFOl 

$«LROT 

t«OCAL 

ifll 'sJPT 

iffSR06 

i#SRQI 

i#SRFC 

SAMPLe $(»CCUT 

$»RCID 

l«RCI D 

S*RCIO 

$«MFL& 

J#MFLG 

S«MFLG 

iSCFLD 

$*(CFLD 

S#! NPT 

S#I NPT 

S#I NPT SAfPLF 

S#TCAL 

**TCAL 

$#TCAL 

$»TCAL 

J#TCAL 

i#TCAL 

t#TCAL 

S#TCAL 

S#TCAL 

t#TCAL 

t«IFLD SAfPLE 

»*TCAL $i»CC*L 

i«SR06 $#SR05 S#SRO^ $#SR03 $#SR02 

S#SR01 S#SROO J#SRFF S#SRFE $*SRFO 

»#SRFC 

$#SR06 $#SR05 $#SRO't $#SR03 t#SR02 

t#5R01 $#SROO i#SRFF $#SRFE t#SRFD 

tiKSRFC 

SAMPLE 

t»TCAL 

t#TOUT 

t#LROF 

ii^ctos 

$»OPEN $#CCAL SAMPLE 

$#OOUT 

S«CLOS $#TC/L SAMPLE 
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©V 



©V 



START 


OVERLAY 


CAT t&GRY 


MAHt AN[j 


c rof. (_fc N 


AaOfif SS 


NU-^BtR 


ARt A 




t.NTRy Hf 


XAOt ■: 1 MAL 


o 06 D 






l^fc 


Sfll Rrjf 


■ ■Ot^^ 


b09 I 






71 


S W')t-i 1' 


■" ^ A 


faOBd 






S/-1 


t tt iPt N 


C, Of. J 


h IHd 






10 / 


ttPGf 1 


r^'A *■ 


i-.i'^^-.j 


^^ 




^ d 


iwnHo/ 


1 OL 


u-t^f 


o 




^8 


$ S 1 M : 


(. C 2 


6 80 J 


__ 


- — 


^ 


tlVLFR TN 


C 1 1". 1 

(0^7 


o8.' / 


1. 


i 


z 


$SC SilP 


CuliJ 


ft d'.'. 


1 


S 


z 


t$SRBk 


CG8.' 


oHCd 
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Overlay segments begin on 2K boundaries (la to Id). 
Four overlay segments in this example. 

Overlays 3 and 4 are not candidates for memory residence because 
of the CATEGORY 125 module. 

REMAP uses more core than MOVE (Example 1 2). 
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Appendix A. Messages 



There are three classes of messages: informational, warning, 
and terminal. The informational messages are indicated by 
an I in print position 7. These messages are printed with- 
out halts. Warning messages are indicated by a W m print 
position 7. A 'P halt with options and 3 is issued with 
warning messages. Terminal messages have a T in position 
7 and are issued with a 'P halt with a 3 option. If two or 
more warning messages are given, the halt indicates the 
first message. If a warning message and a terminal message 
arc printed, the halt applies to the terminal error. 



MESSAGE 



OL016 W ENTRY POINT NAME ON 

OPTIONS CARD WAS NOT FOUND. 



OL020 T TEXT OUT OF SEQUENCE IN 

MODULE WITH BEGIN ADDRESS 
nnnn IN OVERLAY nnn. 

OL021 T MODULE namexx HAS INVALID 
ESL nnnnnn. 



OL022 T INVALID RLD IN namexx AT TEXT 
RECORD ADDRESS nnnn. 



OL023 T UNRESOLVED EXTRN IN MODULE 
WITH BEGIN ADDRESS nnnn IN 
OVERLAY nnn. 

OL024 T EXTERNAL BUFFERS GREATER 
THAN 64K. 

OL025 T MODULE NAMED namexx NOT 
FOUND 



OL026 T PROGRAM WILL NOT FIT IN 
THE MAXIMUM CORE SIZE. 



DESCRIPTION 



The label given as the entry point on the OPTIONS 
statement (ENTRY-latael) was not one of the entry 
points of the object modules. If option is taken, 
the entry point of the mainline routine is used. The 
name on the OPTIONS card should match one of the 
names on the storage map. 

The object text is out of sequence. An ORG instruction 
has caused code to overlay other code. 



The object module named has an invalid ESL in an S-type 
record. If using Basic Assembler, you may have specified 
an invalid EXTRN subtype. Contact your IBM Field 
Engineering program support representative. 

The object module named has a bad text record. The 
error record has the nnnn address in bytes 3 and 4. Con- 
tact your IBM Field Engineering program support 
representative. 

There is an unresolved EXTRN to an entry point. 
Probable user error. 



64K is the maximum allowed for external buffers. 
Reduce buffer size and recompile. 

The name printed in the message was not found by 
AUTOLINK. If the name begins with $, only the pro- 
gram pack was searched. Otherwise both the user pack 
(if specified) and the program pack were searched. To 
correct the error, copy the module to the correct library 
or change the EXTRN to the correct module. 

The maximum storage size is 61-1/4K. (64K minus the 
minimum supervisor) Change the module sizes or 
categories to allow a different overlay structure. 
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MESSAGE 



DESCRIPTION 



OL027 W PROGRAM WILL NOT FIT IN THE 
CORE SIZE SPECIFIED. 



OL031 W MODULE NAMED namexx WAS NOT 
REFERENCED BY AN EXTERN. 



OL032 W MAINLINE MODULE NAME IN 
GROUP OR CATEGORY CARD 



OL033 W A MODULE IN A GROUP CARD HAS 
CATEGORY VALUE 0-7 



OL034 W 



MODULE NAME namexx IN 
CATEGORY OR GROUP CARD NOT 
REFERENCED BY OBJECT PROGRAM. 



OL035 T 



SYSTEM AREA MODULE namexx 
CATEGORY n CALLS MODULE 
namexx. 



Even with overlays, the program will not fit in storage. 
The storage size is either the core size specified on the 
OPTIONS statement (CORE— annK), the core size spe- 
cified to the compiler, or the default of the current par- 
tition size. If more main storage is not available for 
execution, change the module sizes or categories to 
allow a different overlay structure. If this message is 
issued and no overlays are indicated on the storage map, 
overlay segments were not generated for one or more 
of the following reasons: 

1. Overlays would not have provided a storage 
advantage. 

2. All of the object modules had category 0. 

3. Only one overlay segment was available for an 
overlay area. 

A module was read from the system input device 
(READER) or was referenced on an INCLUDE state- 
ment but was not referenced by an EXTRN in the 
object module. An EXTRN must reference the mod- 
ule name for the Overlay Linkage Editor to determine 
the program structure. 

The mainline module name has no meaning in a GROUP 
or CATEGORY statement. The name should be 
removed from the statement. 

The module with the 0-7 category value is ignored when 
grouping modules. If the user wants the module in a spe- 
cific overlay segment, he must supply a CATEGORY 
statement with a value of 8-126, in addition to the 
GROUP statement. If no module named in a GROUP 
statement has a category value of 0-7, this message may 
result from a module being forced to category by the 
linkage editor. This could be the mainline module, a 
non-segment in a segmented COBOL program, a 
zero-length module, or a module called from a system 
module (message OL035). Categories 127, 128, and 255 
are treated as category 0. 

The name in the CATEGORY or GROUP statement is 
not referenced by any of the included or AUTO-LINKED 
modules. The name should be removed or the correct 
name determined from the storage map. 

This message may also appear if a module is named twice 
in CATEGORY assignments. 

A module with category 1-7 can call only modules with 
the same category or category 0. The category of one of 
the modules must be changed. 



MESSAGE 



OL036 W 



OL038 T 



OL042 T 



OL100 



OL101 I 



OL102 



OL103 



OL104 I 



MODULE NAME OR ENTRY POINT 
namexx HAS A DUPLICATE. 



MODULE namexx HAS INVALID ESL 
NUMBER IN TEXT WITH LOAD 
ADDRESS nnnn 



ENTRY POINT IS NOT RELATIVE 
ZERO IN A MODULE WITH COMMON. 



THE TOTAL CORE USED BY namexx 
ISnnnnn DECIMAL. 

THE START CONTROL ADDRESS OF 
THIS MODULE ISxxxx. 

THE NON-OVERLAY CORE SIZE 
IS nnnnnnnn DECIMAL. 

TOTAL NUMBER OF LIBRARY 
SECTORS REQUIRED IS nnnn 
NAME~namexx,PACK-packxx, 
UNIT-nn,RETAIN-r,LIBRARY-R, 
CATEGORY-nnn 

TOTAL NUMBER OF LIBRARY 
SECTORS REQUIRED IS nnnn 
NAME-namexx,PACK~packxx, 
UNIT-nn,RETAIN-r,LIBRARY-0 



DESCRIPTIOIM 



This message can occur for two reasons: 

1. If the name is on the core usage map twice, the 
program contains duplicate entry points or module 
names. If the duplicate entry points or module 
names are not referenced, the program can be 
executed. If the duplicate entry points or module 
names are referenced, the references may be 
resolved to the wrong name and the program will 
not execute correctly. Therefore, the object mod- 
ule should be recreated to eliminate the duplicates. 

2. If the name appears only once, the module was 
included more than once via the SYSIN device or 
INCLUDE statement. The duplicate modules are 
dropped. The duplicate deck or INCLUDE card 
can be removed. 

The object module named has an invalid ESL number in 
a T-type record. The error record has the nnnn address 
in bytes 3 and 4. Contact your IBM Field Engineering 
program support representative. 

The entry point must be the first byte of the module 
because the start control address on the header card is 
used to indicate the load point of the module. The entry 
point must be changed by either recreating the module 
or using the ENTRY parameter on the OPTIONS 
statement. 

The module named requires the amount of main 
storage given by nnnnn to execute. 

The entry point of the root segment is specified by 
xxxx. 

The amount of main storage this program needs to 
execute without overlays is nnnnnnnn. 

This message is issued when the compiler entry is 
used to catalog an object module. 



This describes the load module cataloged into the 
object library. 
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MESSAGE 


DESCRIPTION 


OL105 1 THE CODE LENGTH OF namexx 
ISnnnn DECIMAL. 

OL106 1 THE TOTAL CORE USED FOR 

EXTERNAL BUFFERS BY-namexx 
IS nnnnn DECIMAL. 

OL107 1 THE PARTITION SIZE REQUIRED 
TO EXECUTE THIS PROGRAM 
ISxxK. 


Describes the number of bytes in the R module cataloged 
to the library or punched. This size does not include: 

1. Bytes reserved for COMMON. 

2. Bytes bypassed for boundary alignment. 

3. Bytes used by routines referenced only by 
EXTRNs. 

Total main storage used for external buffers. 

The partition size is determined by adding the values 
specified in messages OL100 and OL106 and rounding 
up to an even multiple of 2K. 
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Appendix B. Object Modules 



The Overlay Unkage Editor accepts object modules for 
link-editing from either disk or card input. Object modules 
contain four types of records which must be in this order; 

H-type = Header Record (optional) 
S-type = External Symbol List (ESL) Records 
T-type = Text-Relocation Dictionary (RLD) Records 
E-type = End Record 



Module Name 

This HSL field provides the symbolic name, start address, 
length in hexadecimal, and category value of the object 
module. 



Entry Point 



Header Record 

A header record is the first record of an object module 
and contains information describing the module. 



External Symbol List (ESL) Records 

An S-type record contains up to five ESL fields. ESL 
fields define areas within an object module and contain 
external references to other modules. The Overlay Linkage 
Editor accepts the following types of ESL fields: 

• Module name 

• Entry point 

• External reference 

External reference (EXTRN) ESLs are divided into seven 
subtypes. These subtypes are: 

• External reference to a module name (EXTRN 
subtype 0) 

• External reference to an entry point (EXTRN 
subtype 128) 

• Weak external reference to a module name (EXTRN 
subtype 3) 

• Weak external reference to an entry point (EXTRN 
subtype 131) 

• GLOBAL COMMON (EXTRN subtype 4) 

• LOCAL COMMON (EXTRN subtype 5) 

• Conditional external reference to a module name 
(EXTRN subtype 6) 

• External buffers (EXTRN subtype 7)-Program Number 
5704-SC2 only 



Tills ESL field provides the entry point name in the module 
and the address of the entry point in hexadecimal. 



External Reference (EXTRN subtypes and 128) 

This ESL field specifies a symbol that is defined as a mod- 
ule name (subtype 0) or entry point (subtype 1 28) in 
another module. The external reference to a module 
name must be to the cataloged module name. The Over- 
lay Linkage Editor searches the system input device (for 
user entry) or SWORK file (for compiler entry) to find a 
iriodule. If the module is not found in the system input 
device or the SWORK file, AUTOLINK is performed. 
AUTOLINK. means that the Overlay Linkage Editor 
searches the R. entries in the object libraries to resolve 
all unresolved external references to module names. 
External references toenlrv points are not resolved by 
AUTOLINK, 

External references to module names are resolved in two 
ways depending on the first character of the module name. 

Eor module names that begin with $. only the program 
pack directory is searched. A special AUTOLINK is per- 
formed for MFCU modules. External references are 
resolved to the .single .MFCU module that includes all the 
functions required by the load module. For example, if 
one object module has an external reference to a MFCU 
punch module and another object module has an external 
reference to a MFCU read module, the single MFCU read- 
punch module is linked. However, if a specific MFCU 
module is entered via the user entry (either on an INCLUDE 
statement or as an R module in the system input device), 
all other MFCU modules referenced by external references 
are linked into the load module. 

Note: This special AUTOLINK does not apply to MFCM 
modules. 



Appendix B. Objcciivc Modules 43 



For any other module name that begins with a vaUd char- 
acter, the order ol'scarcli is: 

1. The user pack (if specified) 

2. Tlie program pack 

If the user pack and the program pack are the same physi- 
cal pack, the pack is searched only once. 

Weak External Reference (EXTRN subtypes 3 and 131) 

The function of the weak external reference is the same as 
for the external reference except no AUTOLINK is per- 
formed. If the Overlay Linkage Editor cannot resolve the 
referenced name, the weak external reference is ignored 
and remains unresolved. 

GLOBAL COMMON Area (EXTRN subtype 4) 

Tills ESL record specifies a space allocation for a GLOBAL 
COMMON area. This area is allocated at the start of the 
program level. The size of the area is the size of the largest 
COMMON area encountered. Tliis area is saved across 
INVOKE (one FORTRAN program calling another and 
transferring control to the called program) if the called 
program contains the GLOBAL COMMON ESL. The 
Overlay Linkage Editor sets the program common attribute 
in the load module. 

LOCAL COMMON Area (EXTRN subtype 5) 

Tlie Overlay Linkage Editor allocates an area of main 
storage for the COMMON area either at the beginning 
of the program level or immediately following the storage 
reserved for the GLOBAL COMMON. This area is used 
by modules within the same program and is not saved 
across INVOKE. 

Conditional External Reference (EXTRN subtype 6) 

The function of the conditional external reference is the 
same as for the external reference (in other words, 
AUTOLINK is performed), except that if the Overlay 
Linkage Editor cannot resolve (find) the referenced 
name, the conditional external reference is ignored and 
remains unresolved. 



External Buffers (EXTRN subtype 7) - Program Number 
5704-SC2 Only 

The Overlay Linkage Editor accumulates the length of the 
required external buffers and places that length in the 
object library directory entry for the program being 
cataloged. 



Text— Relocation Dictionary (RLD) Records 

T-type records contain the object code of modules to be 
link-edited. T-type records also contain the information 
needed to make the text relocatable. The load addresses 
on the text records must be in ascending order, and the 
text must not overlap from one text record to the next. 

Each record is 64 bytes long in the following format; 
Byte Contents 

T (denotes text— RLD record). 

1 Length minus 1 of object text contained 
in the record. 

2-3 Address of the rightmost byte of object 

text in the record. 

4-63 Object text begins in byte 4; 1-byte or 3- 

byte RLD (relocation dictionary) entries 
are inserted beginning in byte 63 from right 
to left. Unused bytes (at least one) between 
text and RLD contain X'OO'. RLD points 
to riglit end of address (displaced from 
beginning of text). 

One-byte RLD 

Each 1-byte RLD entry contains the following: 
Bit Meaning 







2-7 



0=RLD points to the rightmost byte of an 
address within this module. 

I = RLD points to an EXTRN. 

0=1 -byte RLD. 

Displacement from the leftmost text byte 
in the record. EHsplacement count starts 
with 00. 
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Three-byte RLD 



Three-byte RLDs are generated by the compiler for exter- 
nal references when a displacement from an external sym- 
bol is specified in a source statement. These RLDs are re 
quired to support programs referencing a common data 
area which may be considered external to all included 
modules. Each 3-byte RLD contains the following: 



Rvte 



Bit Meaning 



1-2 (leftmost) all 



3 (rightmost) 



Relative EXTRN ESL count so 
name of the EXTRN can be 
found. Relative ESL count 
starts with 0001. 

1 = RLD points to an EXTRN 
with a known displacement. 



2-7 



l=3-byte RLD. 

Displacement from the left- 
most text byte in the record. 



Three-byte RLDs are processed like 1-byte RLDs except 
that the base address is the address defined in the ESL 
entry corresponding to the relative EXTRN count. 

End Record 

An E-type record must be the last record of an object 
module. 
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Appendix C: Performance Improvements 



You can reduce the time required to link-edit a program by 
using one or more of the following procedures: 

1. Do not request a cross-reference list. For many programs 
the time saved may be small, but for programs with many 
module names and entry points, along with many refer- 
ences to these module names and entry points, significant 
time saving can result. The time saved is not only the 
amount of time needed to print the list, but also the 
additional time needed during the link-edit to save all 

the information on disk. 

2. Locate the work files, SWORK and SSOURCE, optimally. 

a. On a multi-drive system, the program pack and user 
pack (if one is used) should not be on the same drive 
as the SWORK and SSOURCE files. 

b. On a single drive system, the work files should be 
located at the beginning of the library. This can be 
done by using the Library Maintenance program 
ALLOCATE statement to first allocate the source 
library to 30 tracks and then deallocate it to tracks. 
The 30 tracks are then available at the start of the 
library and can be used for the work files by specifying 
the LOCATION parameter on the FILE statements. 

c. On a single drive system, if the work files cannot be 
located at the beginning of the library (as in step b), 
they should be located opposite the object library on 
the other disk drive. For example, if the object 
library is located at tracks 28 or 37 on PI , the work 
files should be located at tracks 28 to 37 on Rl. 

d. For the Model 1 5. files should be placed on a 5445 
disk drive for best performance. 

e. If steps a, b, c, and/or d are not used to optimally lo- 
cate the work files, no FILE statements should be pro- 
vided. The hnkage editor finds the work space 
needed. 



3. Load the Overlay Linkage Editor from a program pack 
containing only the Compiler, the Overlay Linkage 
Editor, and the R modules to be link-edited. This is more 
efficient than loading the Overlay Linkage Editor from 
the system pack. 

4. Place the object modules (R modules) that will be used 
in the link-edit ahead of the load modules in the object 
library. This would be most effective with step 2b. 

5. Have the hnkage editor locate the needed object modules 
via AUTOLINK rather than by you supplying multiple 
INCLUDE cards. 

6. Use the memory resident overlay techniques to increase 
the performance of large overlay programs. Which 
technique to use depends on the impact that the 2K 
boundary restriction has on the program. Because 
adjusting ATRs takes less time than moving the data 
(especially for large overlay segments), REMAP object 
modules generally produce a larger execution storage 
size and fit fewer segments into the resident area of the 
partifion, but generally execute in less time than MOVE 
object modules. 
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Glossary 



Hie following terms arc defined as they are used in this 
manual. If you do not find the term you are looking for, 
refer to the index or to the IBM Data Processing Glossan\ 
GC20-1699. 

AUTOUNK. Process whereby the Overlay Linkage Editor 
searches the object library for object modules to resolve 
all unresolved module name external references. 

COMMON. An area at the beginning of a partition or fol- 
lowing a GLOBAL area. 

conditional external reference. An externa! reference that 
causes AUTOLINK to be performed. However, if the 
module named by die conditional external reference is 
not found, no error message is printed and the conditional 
external reference is treated as a weak external reference. 

descendant. In a caller-called relationship between two 
modules, the called module is the descendant. 

external reference. (I) A reference to a symbol that is 
defined as an external name m another module. (2) An 
external symbol that is defined in anothei module; that 
which is defined in the assembler language by an LXTRN 
statement, and is resolved durmg linkage editing. See 
also weak external reference. 

fetch routine. The routine to find the overlay on disk and 
load it to storage. 

fetch table. The parameter needed to load a single (werlay. 

GLOBAL. An area of main storage at the beginning of a 
partition. 

INVOKE. Process where one load module calls and trans- 
fers control to another load module. 

load module. The output of the linkage editor; a program 
in a format suitable for loading into main storage for 
execution. 

mainline. The first module encountered when link-editing. 
This module is always in the root segment. 

memory-resident overlay. The technique used to increase 
the performance of large overlay programs by allowing 
certain overlay segments to remain in primary storage after 
the initial segment fetch. 



MRO. Memory resident overlay. 

O module. A load module. 

obicct libraiy. An area on disk that contains load modules 
and object modules. 

object module. A module that is the output of an assem- 
bler or compiler and is input to the linkage editor. 

object program. A foully compiled or assembled and link- 
edited program that is ready to be loaded into main 
storage. 

overlay. ( I ) Tlie technique of repeatedly using the same 
blocks of interna! storage during dilTcenf stages of a pro- 
gram. When one module is no longer needed in storage, 
another module can replace all or part of it. (2) A pro- 
gram segment or phase that is loaded into main storage. 
It replaces all or part of a previously loaded segment. 

overlay module. A load module thai has been divided into 
overlay segments, and that has been provided by the Over- 
lay Linkage Lditor with information that enables the Over- 
lay Fetch Routine to implement the desired loading of 
segments when requested. 

overlay program. A program in which certain control sec- 
tions can use the same storage locations at different times 
during execution. 

overlay region. A continuous area of main storage in which 
segments can be loaded independently of other regions. 

overlay segment. See segment. 

program pack. The disk pack from which the Overlay 
Linkage Editor program is loaded. 

root segment. That segment of an overlay program that 
remains in main storage at all times during the execution 
of the overlay program; the first segment in an overlay 
program. A root segment cannot be overlaid. 

R module. An object module. 

segment. A part of a computer program divided into parts 
such that the program can be executed without the entire 
program being in main storage at any one time. 
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system pack. The disk pack from which the system is loaded 
(IPL pack). 

transfer vector. The linkage to each entry point in an 
overlay that allows the overlay to be loaded to storage 
before control is passed to the entry point. 

user pack. A disk pack that contains object modules to be 
link-edited. 

weak external reference. An external reference that does 
not have to be resolved during linkage editing. If it is not 
resolved, it appears as though its value was resolved to zero. 
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Index 



address, iink-edit start 16 
address, overlay program load 16 
alignment, modules on a boundary 10 
allocating work files (see examples) 
ARKA-USER parameter 

co-residenl area 14 

GROUP statement 9 
arithmetic overlay segment, system 14 
assignment, modules to overlays 9 
assignment, modules to root segment 16 
assignment, overlays 14 
ATTR parameter. OPTIONS statement 8 

(see example 1 ) 
attributes of load module 8 
AUTOLINK 43 



compiler object modules 9 
conditional external reference, ESL 

record 44 

configuration, system 3 
control statements 

description .S 

examples 23 
CORE parameter. OPTIONS statement 7 
co-resident area 14 

(see examples 6-11) 
cross-reference list 

MAP parameter 8 

storage map 12 



boundary alignment of modules 10 
BSCA modules, category value change 9 
buffers, external (5704-SC2 onlv) 44 



descendant, mainline 14 
design, overlay structure 9 
destination of load module, PHASE 
statement 6 

determining overlay modules 16 
disk space, linkage editor 4 



CATEGORY statement 5,9,19 
category value 

change 9 
(see examples 6-11) 

system modules 14 
Category, storage map heading 12 
CCP, memory resident overlay 19 
change category value 9 

(see examples 6-11) 
changing overlay structure (see examples 6-1 1) 
checkpomt restart program 8 

(see example 1) 
COBOL, user overlay area 14 
Code Length Decimal, storage map heading 12 
Code Length Hexadecimal, storage map heading 12 
common areas 

GLOBAL 13,44 

LOCAL 13,44 
communications control program, memory 
resident overlay 19 
compiler entry 

description 4 

functions 2 



end record, object module 45 
END statement 5, I 1 
ENTRY parameter 

(see example 3) 

OPTIONS statement 7 
entry point 

ESL records 43 

load modules 18 
(see ENTRY parameter) 
entry, compiler 4 
Entry, storage map heading 12 
entry, user 4 
EQUATE statement 5, 1 1 
error halts 3 
error messages 38 
ESL (external symbol list) records 43 
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examples 
example 1, OCL and eonlrol statements 23 
example 2, OCL and control statements 24 
example 3, OCL and control statements 25 
example 4, OCL and control statements 
(Model 15 only) 26 

example 5. OCL and control statements 26 
example 6, overlay structure of load module 27 
example 7, overlay structure of load module 29 
example 8, overlay structure of program 31 
example 9. overlay structure of program 32 
example 10. overlay structure of program 33 
example 1 1, (>verlay structure of program 34 
example 12, MOVE technique (Model 15 only) 35 
example 13. RfvMAP technique (Model 15 only) 36 

extended root mainline 14 

external buffers (57()4-SC2 only) 44 

external relerence. E-^SL records 43 

external symbol list records 43 

LX I'RN (sec ESL records) 



fetch routine, overlay (see overlay fetch 
routine) 
fetch table 
generation 14 
root area I 3 
1 11.1 slatemcnls 4 
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13. 20, 21, 22 



LORLRAN 22. 44 



generation, overlays 
memory resident overlays 
overlay fetch routine 14 

CiLOBAL COMMON area 

GROUP statement 5. 9 
(see examples 4 and 7) 
description 18 
system modules 14 

grouping modules 18 



halts, error 3 
header record 43 



I/O dependent modules, user overlay 
areas 1 3 

I/O independent modules, co-resident 
area 14 

improvements, performance 47 
INCLUDE statement 5 
description 9 
mainline routine 14 



including modules in root 18 

increase size of user area (see example 7) 

informational messages 38 

INVOKE feature 
GLOBAL COMMON 44 
LOCAL COMMON 44 
memory resident overlays 22 



language translator 1 

last control statement (see END statement) 

LEVEL parameter 

(see example I ) 

OPTIONS statement 7 
library format, object 2 
link-edit start addresses 16 

LINKADD parameter, PHASE statement 6, 16 
linkage editor 

control statements 5 

functions 2 

loading 4 

processing 1 
load address, overlay programs 16 
load module 

control statements 5 

destination 6 

entry point 18 
(see ENTRY parameter) 

introduction I 

name 6 

RETAIN type 6 

size change 3, 14 
(sec CORE parameter) 

storage map 12 

storage size 7 
loading linkage editor 4 
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location of user modules (see UPACK parameter) 



mainline routine 

assignment 9 
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(sec example 3) 

entry point (see ENTRY parameter) 

INCLUDE statement (see examples 1, 2, and 4) 

overlay assignment 14 

root area 13 
MAP parameter, OPTIONS statement 8 
memory resident overlay 

Communications Control Programming 19 

description 19 

examples 35, 36 

MOVE technique 21 

performance considerations 47 

program execution 20 

REMAP technique 22 

supervisor support 19 
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module 
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Pll ASI statement 6 
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ohjeet module 
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description 43 

CiROL P statement 9 

introduction I 
OC'L. statements 

description 4 

examples 23 
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one-bvte RLI) 44 
OP'I IONS statement .^ 

description 7 

memory resident overlavs 19 
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overlay area 
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residem 20 
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si/e 14. 22 
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Overlay Number, storage map heading 12 
overlay programs, load address 16 
overlay segments, system 14 
overlav storage si/e I 2 
overlay struelure 

change (see examples (>- 1 I ) 

design 9 
overlavs 

letch routine 14, 20, 22 

memorv resident 19 
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parameter sumniarv f> 
perlormancc improvements 47 
permanenl load modules 6 
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description fi 
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prioritv (see categorv value) 
processing, linkage editor I 
program failure, categorv value change 9 
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paramelerl 
program, source I 
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punching objecl module (see PL'NLII 

parameter) 



Referenced Bv. storage map heading 12 
Relocation IJielionary Records 44 
REMAP technique, memorv resident 

overlav 19 

resident overlav area 20 
resident overlav program execution. 

memorv 20 

Rl r.AlN p.ir.inielcr. I'll ASI slalemenl d 
RLIJ paiameler. PIl.ASl slalemenl (i 
RLD records 44 
root .irea. contents 1 v 20. 2 1 . 22 

(see examples d- 1 3 ) 
root niainliiie. extended 14 
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second. irv sloragc rcqiiircnients 3 

scgniunts, loading ovcrla\ 14, 20. 22 

>i/c, ovcrlav Iclcli couliiic 14. 19 

source progr.ini I 

start address, link-edit 16 

Stan .-\ddress, storage tiiap heading 12 

stalenienls, control ,s 

slalenients, 0( L 4 

storage map 

contents 12 

M,\P parameter « 
storage ree)inretiienls 

prmiarv ,'' 

secondar\ 3 
storage si/c, load nK^dule 7 
storage si/c. noii-tnerlav 12 
storage si/e, o\erla> 12 
subtype, external relcrences 43 
symbol list records, external 43 
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sNstem configuration 3 
system modules 
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sNstem modules, category value change 9 
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warning messages 3S 

weak external references, f'SL record 44 



leclimques, memorv resident t)verlav 

MOM 19 
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text-KI.I) record 44 
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